docs: update status to beta and improve command documentation

Change-Id: Iaa05374793c755db76705b6e4c4053b4b2beebe7
Signed-off-by: Thomas Kosiewski <[email protected]>

Author: ThomasK33

.github/workflows/claude.yml

@@ -34,4 +34,3 @@ jobs:
         uses: anthropics/claude-code-action@beta
         with:
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
-

DEVELOPMENT.md

@@ -35,7 +35,7 @@ claudecode.nvim/
 | Lock file management   | ✅ Done    | -        | Basic implementation complete            |
 | Selection tracking     | ✅ Done    | -        | Enhanced with multi-mode support         |
 | MCP tools              | 🚧 Started | Medium   | Basic framework, need more tools         |
-| Tests                  | ✅ Done    | -        | 55 tests passing, comprehensive coverage |
+| Tests                  | ✅ Done    | -        | 56 tests passing, comprehensive coverage |
 | CI pipeline            | ✅ Done    | -        | GitHub Actions configured                |
 | Documentation          | ✅ Done    | -        | Complete documentation                   |
 

README.md

@@ -2,7 +2,7 @@
 
 [![Tests](https://github.com/coder/claudecode.nvim/actions/workflows/test.yml/badge.svg)](https://github.com/coder/claudecode.nvim/actions/workflows/test.yml)
 ![Neovim version](https://img.shields.io/badge/Neovim-0.8%2B-green)
-![Status](https://img.shields.io/badge/Status-alpha-orange)
+![Status](https://img.shields.io/badge/Status-beta-blue)
 
 A Neovim plugin that integrates with Claude Code CLI to provide a seamless AI coding experience in Neovim.
 
@@ -222,14 +222,19 @@ require("claudecode").setup({
 
 ## Commands
 
-- `:ClaudeCodeStart` - Start the Claude Code integration server
-- `:ClaudeCodeStop` - Stop the server
-- `:ClaudeCodeStatus` - Show connection status
 - `:ClaudeCodeSend` - Send current selection to Claude
 - `:ClaudeCode` - Toggle the Claude Code interactive terminal window
 - `:ClaudeCodeOpen` - Open (or focus) the Claude Code terminal window
 - `:ClaudeCodeClose` - Close the Claude Code terminal window
 
+Note: The server starts automatically when the first command is used. To manually control the server, use the Lua API:
+
+```lua
+require("claudecode").start()  -- Start server
+require("claudecode").stop()   -- Stop server
+require("claudecode").status() -- Check status
+```
+
 ## Keymaps
 
 No default keymaps are provided. Add your own in your configuration: