docs: update cli

1 files changed, 123 insertions, 27 deletions

diff --git a/packages/web/src/content/docs/docs/cli.mdx b/packages/web/src/content/docs/docs/cli.mdx
index 9d93c2330..69f2c39a6 100644
--- a/packages/web/src/content/docs/docs/cli.mdx
+++ b/packages/web/src/content/docs/docs/cli.mdx
@@ -101,22 +101,16 @@ Both the `/editor` and `/export` commands use the editor specified in your `EDIT
 
 <Tabs>
   <TabItem label="Linux/macOS">
-    ```bash
-    export EDITOR=nano # or vim, code, etc.
-    ```
-    To make it permanent, add this to your shell profile; `~/.bashrc`, `~/.zshrc`, etc.
+    ```bash export EDITOR=nano # or vim, code, etc. ``` To make it permanent, add this to your shell profile;
+    `~/.bashrc`, `~/.zshrc`, etc.
   </TabItem>
   <TabItem label="Windows (CMD)">
-    ```bash
-    set EDITOR=notepad # or code, vim, etc.
-    ```
-    To make it permanent, use **System Properties** > **Environment Variables**.
+    ```bash set EDITOR=notepad # or code, vim, etc. ``` To make it permanent, use **System Properties** > **Environment
+    Variables**.
   </TabItem>
   <TabItem label="Windows (PowerShell)">
-    ```bash
-    $env:EDITOR = "notepad" # or "code", "vim", etc.
-    ```
-    To make it permanent, add this to your PowerShell profile.
+    ```bash $env:EDITOR = "notepad" # or "code", "vim", etc. ``` To make it permanent, add this to your PowerShell
+    profile.
   </TabItem>
 </Tabs>
 
@@ -136,28 +130,25 @@ The opencode CLI also has the following commands.
 
 ---
 
-### run
+### agent
 
-Run opencode in non-interactive mode by passing a prompt directly.
+Manage agents for opencode.
 
 ```bash
-opencode run [message..]
+opencode agent [command]
 ```
 
-This is useful for scripting, automation, or when you want a quick answer without launching the full TUI. For example.
+---
 
-```bash "opencode run"
-opencode run Explain the use of context in Go
-```
+#### create
 
-#### Flags
+Create a new agent with custom configuration.
 
-| Flag         | Short | Description                                |
-| ------------ | ----- | ------------------------------------------ |
-| `--continue` | `-c`  | Continue the last session                  |
-| `--session`  | `-s`  | Session ID to continue                     |
-| `--share`    |       | Share the session                          |
-| `--model`    | `-m`  | Model to use in the form of provider/model |
+```bash
+opencode agent create
+```
+
+This command will guide you through creating a new agent with a custom system prompt and tool configuration.
 
 ---
 
@@ -209,6 +200,102 @@ opencode auth logout
 
 ---
 
+### github
+
+Manage the GitHub agent for repository automation.
+
+```bash
+opencode github [command]
+```
+
+---
+
+#### install
+
+Install the GitHub agent in your repository.
+
+```bash
+opencode github install
+```
+
+This sets up the necessary GitHub Actions workflow and guides you through the configuration process. [Learn more](/docs/github).
+
+---
+
+#### run
+
+Run the GitHub agent. This is typically used in GitHub Actions.
+
+```bash
+opencode github run
+```
+
+##### Flags
+
+| Flag      | Description                                      |
+| --------- | ------------------------------------------------ |
+| `--event` | GitHub mock event to run the agent for           |
+| `--token` | GitHub personal access token  |
+
+---
+
+### models
+
+List all available models from configured providers.
+
+```bash
+opencode models
+```
+
+This command displays all models available across your configured providers in the format `provider/model`.
+
+---
+
+### run
+
+Run opencode in non-interactive mode by passing a prompt directly.
+
+```bash
+opencode run [message..]
+```
+
+This is useful for scripting, automation, or when you want a quick answer without launching the full TUI. For example.
+
+```bash "opencode run"
+opencode run Explain the use of context in Go
+```
+
+#### Flags
+
+| Flag         | Short | Description                                |
+| ------------ | ----- | ------------------------------------------ |
+| `--continue` | `-c`  | Continue the last session                  |
+| `--session`  | `-s`  | Session ID to continue                     |
+| `--share`    |       | Share the session                          |
+| `--model`    | `-m`  | Model to use in the form of provider/model |
+| `--agent`    |       | Agent to use                               |
+
+---
+
+### serve
+
+Start a headless opencode server for API access.
+
+```bash
+opencode serve
+```
+
+This starts an HTTP server that provides API access to opencode functionality without the TUI interface.
+
+#### Flags
+
+| Flag         | Short | Description                                |
+| ------------ | ----- | ------------------------------------------ |
+| `--port`     | `-p`  | Port to listen on          |
+| `--hostname` | `-h`  | Hostname to listen on |
+
+---
+
 ### upgrade
 
 Updates opencode to the latest version or a specific version.
@@ -229,17 +316,26 @@ To upgrade to a specific version.
 opencode upgrade v0.1.48
 ```
 
+#### Flags
+
+| Flag       | Short | Description                                               |
+| ---------- | ----- | --------------------------------------------------------- |
+| `--method` | `-m`  | The installation method that was used; curl, npm, pnpm, bun, brew |
+
 ---
 
 ## Flags
 
-The opencode CLI takes the following flags.
+The opencode CLI takes the following global flags.
 
 | Flag           | Short | Description                                |
 | -------------- | ----- | ------------------------------------------ |
 | `--help`       | `-h`  | Display help                               |
 | `--version`    |       | Print version number                       |
 | `--print-logs` |       | Print logs to stderr                       |
+| `--log-level`  |       | Log level (DEBUG, INFO, WARN, ERROR)       |
 | `--prompt`     | `-p`  | Prompt to use                              |
 | `--model`      | `-m`  | Model to use in the form of provider/model |
 | `--mode`       |       | Mode to use                                |
+| `--port`       |       | Port to listen on             |
+| `--hostname`   |       | Hostname to listen on  |