Skip to content

docs: cover browser controls in CLI contract #16779

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
teamleaderleo merged 2 commits into from
Oct 3, 2026
Merged

docs: cover browser controls in CLI contract #16779

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ba689ea
docs: cover browser control commands
BlueRaddish Oct 2, 2026
d9e78db
Probe the browser lines through cmux help browser
teamleaderleo Oct 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 16 additions & 1 deletion docs/cli-contract.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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. |
Comment thread
coderabbitai[bot] marked this conversation as resolved.
| `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. |
Expand All @@ -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. |
Expand Down Expand Up @@ -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'`
Expand Down
Loading