Command Reference | BCTRL Docs

This reference is generated from the CLI command tree, so command names, arguments, and flags stay aligned with the installed bctrl binary.

For command-specific help in a terminal, run:

$ bctrl --help
$ bctrl <command> --help
$ bctrl <command> <subcommand> --help

Global output flags

Most data commands return JSON by default and support these formatting flags:

Flag	Description
`--json [fields]`	Output JSON with optional comma-separated field projection.
`--jq <expression>`	Filter JSON output using a jq expression.
`--template <template>`	Format JSON output using a Handlebars template.
`--no-color`	Disable color output.

Pagination (-L, --limit and --cursor), confirmation (-y, --yes), and request override flags (--params, --body) appear on the generated command pages where supported.

Command groups

Group	Commands	Description
Authentication	`auth`	Log in, inspect auth state, print tokens, and log out.
Spaces	`space`	Create and manage spaces and their mounted environment.
Runtimes	`runtime`	Create, start, stop, configure, and drive browser runtimes.
Runs	`runs`	Inspect trace spans and events, or stream both live.
Views	`view`	Create, list, inspect, and revoke expiring human-facing views.
Webhooks	`webhook`	Manage signed webhooks and inspect or redeliver their deliveries.
Files	`file`	Upload, download, update, and delete durable files.
Tools	`tools`, `toolsets`, `tool-calls`	Define tools, bundle toolsets, and inspect tool calls.
Conversations	`conversations`	Manage persistent conversations and stream their events.
AI	`ai`	Discover managed models and manage BYOK AI credentials.
Proxies	`proxy`	Manage proxies and browse managed proxy pools.
Extensions	`browser-extension`	Upload, import, list, update, and delete browser extensions.
Account	`account`, `api-key`, `notification-recipient`, `subaccount`, `usage`	Manage branding, API keys, notification recipients, subaccounts, and usage.
Help	`help`, `version`	Read operation-aware API, SDK, CLI, and MCP help.

Top-level commands

version, account, auth, ai, api-key, browser-extension, conversations, file, help, notification-recipient, runs, runtime, proxy, space, subaccount, tools, toolsets, tool-calls, usage, view, webhook