Tabfleet CLI
Use the official Tabfleet command-line tool to create, list, inspect, connect to, and close cloud browser sessions.
Install and authenticate
The official CLI ships in @tabfleet/sdk version 0.2.0 and later. Use Node.js 22 or later. Run it with npx, or install globally with npm install -g @tabfleet/sdk to make the tabfleet command available. Source: tabfleet/sdk-typescript.
Create a workspace API key in the dashboard and set TABFLEET_API_KEY in your environment. Help, version, and health work without a key. Use the CLI for shell scripts and agent workflows that manage browser sessions; use a CDP client to interact with pages.
npx @tabfleet/sdk --help
npx @tabfleet/sdk health
npx @tabfleet/sdk sessions list --limit 25
npx @tabfleet/sdk usageCreate, inspect, and close a browser
Creation consumes workspace allowance and requires a control-capable key. Persist an idempotency key with the job, then reuse the same key and options when retrying that job. No commands retry automatically. Duration ranges from 60 to 3600 seconds; idle timeout ranges from 60 to 600 seconds.
Replace SESSION_UUID with the returned session ID. Create and connection output can contain temporary signed credentials: keep that output private. Close can return a closing state while cleanup is pending; inspect the session again to confirm completion.
npx @tabfleet/sdk sessions create --idempotency-key my-job-0001 --duration 300 --idle-timeout 60
npx @tabfleet/sdk sessions get SESSION_UUID
npx @tabfleet/sdk sessions connection SESSION_UUID
npx @tabfleet/sdk sessions close SESSION_UUIDJSON output, pagination, and errors
Successful API commands write JSON to stdout. Errors write JSON to stderr. Exit code 0 means success, 1 means a request failed, and 2 means invalid arguments or configuration. Help and version are plain text. HTTP errors include status, code, message, and retryAfter in seconds when available. Respect that delay before retrying.
sessions list returns one page. Pass the returned nextCursor with --cursor to continue; nextCursor null marks the end. --limit accepts 1 to 100. The default request timeout is 30 seconds. TABFLEET_API_URL optionally overrides the API origin for development; HTTPS is required except for localhost.