chat (#1163)

* chat

* docs

* fmt

docs/src/app/commands/page.mdx

@@ -346,6 +346,28 @@ agent-browser dashboard stop          # Stop the dashboard server
 agent-browser dashboard install       # Install the dashboard files
 ```
 
+## Chat
+
+Use natural language to control the browser via AI. The `chat` command translates instructions into agent-browser commands, executes them, and streams the AI response. Requires `AI_GATEWAY_API_KEY` to be set.
+
+```bash
+agent-browser chat "open google.com and search for cats"     # Single-shot instruction
+agent-browser chat                                           # Interactive REPL (type quit to exit)
+echo "summarize this page" | agent-browser chat              # Piped input
+agent-browser -q chat "summarize this page"                  # Quiet: text only, no tool calls shown
+agent-browser -v chat "fill in the login form"               # Verbose: show commands and their output
+agent-browser --model openai/gpt-4o chat "take a screenshot" # Override the default AI model
+agent-browser --json chat "open example.com"                 # Structured JSON output
+```
+
+Chat-specific options:
+
+```bash
+--model <name>           # AI model (or AI_GATEWAY_MODEL env, default: anthropic/claude-sonnet-4.6)
+-v, --verbose            # Show tool commands and their raw output
+-q, --quiet              # Show only the AI text response (hide tool calls)
+```
+
 ## Navigation
 
 ```bash
@@ -388,6 +410,9 @@ agent-browser reload                  # Reload page
 --action-policy <path>   # Path to action policy JSON file
 --confirm-actions <list> # Action categories requiring confirmation
 --confirm-interactive    # Interactive confirmation prompts (auto-denies if stdin is not a TTY)
+--model <name>           # AI model for chat (or AI_GATEWAY_MODEL env)
+-v, --verbose            # Show tool commands and their raw output (chat)
+-q, --quiet              # Show only AI text responses (chat)
 --config <path>          # Use a custom config file
 --debug                  # Debug output
 ```