diff --git a/docs/cli-contract.md b/docs/cli-contract.md
index 3a62da9b079c..60efa06fad6d 100644
--- a/docs/cli-contract.md
+++ b/docs/cli-contract.md
@@ -654,6 +654,12 @@ Browser subcommands:
 | `browser open`, `browser open-split`, `browser new` | Create or open a browser surface. |
 | `browser goto`, `browser navigate` | Navigate to a URL. |
 | `browser back`, `browser forward`, `browser reload` | Navigate browser history or reload. |
+| `browser react-grab toggle` | Toggle React grab for the selected browser surface; `--return-to <terminal-surface>` routes the result back to a terminal. |
+| `browser devtools toggle`, `browser devtools console` | Toggle Web Inspector or show the browser console for an optional `--surface`. |
+| `browser focus-mode enter`, `browser focus-mode exit`, `browser focus-mode toggle` | Change focus mode for an optional `--surface`; `on` and `off` are also accepted. |
+| `browser design-mode enable`, `browser design-mode disable`, `browser design-mode toggle`, `browser design-mode status` | Change or read design mode for an optional `--surface`; bare `design-mode` reads status. |
+| `browser zoom in`, `browser zoom out`, `browser zoom reset`, `browser zoom <factor>` | Change page zoom for an optional `--surface`; a numeric factor sets absolute zoom. |
+| `browser history clear --force` | Permanently clear the default browser profile's history, like the View menu action; `--yes` also confirms. |
 | `browser url`, `browser get-url` | Print current URL. |
 | `browser focus-webview`, `browser is-webview-focused` | Focus or query webview focus. |
 | `browser snapshot` | Print a DOM snapshot. |
@@ -677,7 +683,8 @@ Browser subcommands:
 | `browser cookies` | Get, set, or clear cookies; `set` accepts `--http-only` to keep the cookie hidden from page JavaScript. `clear` requires an explicit scope such as `--url`, `--domain`, `--name`, or `--all`, and returns the removed count as `cleared` in JSON output. |
 | `browser storage` | Get, set, or clear local/session storage. |
 | `browser tab` | Create, list, switch, or close browser tabs. |
-| `browser console`, `browser errors` | List or clear console messages and errors. |
+| `browser console list`, `browser console clear` | List or clear console messages for the selected browser surface. |
+| `browser errors list`, `browser errors clear` | List or clear browser errors for the selected surface. |
 | `browser highlight` | Highlight an element. |
 | `browser state` | Save or load browser state. |
 | `browser addinitscript`, `browser addscript`, `browser addstyle` | Inject scripts or CSS. |
@@ -1131,6 +1138,14 @@ the expected text without connecting to a cmux socket.
 - `cmux simulate-app-active --help` -> `Usage: cmux simulate-app-active`
 - `cmux claude-hook --help` -> `Usage: cmux claude-hook`
 - `cmux browser --help` -> `Usage: cmux browser`
+- `cmux help browser` -> `browser react-grab toggle [--surface <id>] [--return-to <terminal-surface>]`
+- `cmux help browser` -> `browser devtools toggle|console [--surface <id>]`
+- `cmux help browser` -> `browser focus-mode enter|exit|toggle [--surface <id>]`
+- `cmux help browser` -> `browser design-mode enable|disable|toggle|status [--surface <id>]`
+- `cmux help browser` -> `browser zoom in|out|reset|<factor> [--surface <id>]`
+- `cmux help browser` -> `browser history clear --force`
+- `cmux help browser` -> `browser console <list|clear>`
+- `cmux help browser` -> `browser errors <list|clear>`
 - `cmux browser --help` -> `screenshot [--out <path>] [--json]`
 - `cmux browser --help` -> `download list [--limit <1...25>] [--json]`
 - `cmux open-browser --help` -> `Legacy alias for 'cmux browser open'`