band browsers

The band browsers command group manages browser tabs attached to a workspace. Each tab is rendered by the desktop app's embedded browser view; the CLI can create, navigate, inspect, and remove them. Useful for previewing dev servers next to the chat pane or auto-positioning docs alongside the editor.

Default workspace and browser resolution

Every band browsers subcommand auto-detects the workspace from the current working directory when [workspace_id] is omitted, and resolves to the workspace's first browser tab when [browser_id] is omitted.

List browser tabs

band browsers list
band browsers list ws_abc123

Create a tab

band browsers create                                  # blank tab
band browsers create --url https://example.com --name "docs"

Options:

• workspace_id (positional, optional) — auto-detected from cwd if omitted.
• --url <url> — initial URL.
• --name <label> — display name for the tab.

Navigate

The browser ID is positional; the URL is passed via --url.

band browsers navigate --url https://example.com/changelog
band browsers navigate b_abc --url https://example.com/changelog

Get the current state

band browsers get                # cwd workspace's first browser tab
band browsers get b_abc          # specific tab

Remove a tab

band browsers remove
band browsers remove b_abc

JSON output

band browsers list --output json
band browsers list --output json | jq '.browsers[].id' | \
  xargs -n1 band browsers remove