band-browser

Band Browser Tabs

Browser tabs are web views attached to a Band workspace. Each tab has its own URL and status, and can be driven from the CLI.

This skill is focused on browser tab management only. For broader operations see the sibling skills:

• band — workspaces, projects, cronjobs, tunnel, settings.
• band-chat — agent chat panes inside a workspace.
• band-terminal — terminal sessions inside a workspace.

Prerequisites

The Band server must be running (started by the Band dashboard app). Connects to http://localhost:3456 by default. See the band skill for general setup and the workspace lifecycle.

JSON Output

All commands support --output json (or BAND_OUTPUT=json env var) for structured output.

• Success: JSON object to stdout, exit code 0
• Error: {"error": "message"} to stderr, exit code 1

Commands

List browser tabs for a workspace

band browsers list [workspace_id]

Text output: ID\tNAME\tURL\tSTATUS (tab-separated table). JSON output: {"browsers": [{"id": "...", "name": "...", "url": "...", "status": "..."}]}

Create a new browser tab in a workspace

band browsers create [workspace_id] [--url <string>] [--name <string>]

Text output: the new browser tab ID. JSON output: {"browser": {"id": "...", ...}}

Navigate a browser tab to a URL

band browsers navigate [browser_id] --url <string>

Updates the browser tab's URL in the server state. When browser_id is omitted, auto-detects the workspace from cwd and targets that workspace's first browser tab. Mirrors the shape of chats send [chat_id] --message ... and terminals send [terminal_id] --data ... — panel ID is positional, data is a flag.

Get a browser tab's current state

band browsers get [browser_id]

Text output: formatted key-value pairs. JSON output: {"browser": {"id": "...", "name": "...", "url": "...", "status": "..."}}

Remove a browser tab

band browsers remove [browser_id]