Browsable CLI

Installable CLI for the Browsable REST API and MCP-equivalent workflows.

npm install -g @browsable-app/cli
browsable login
browsable tasks list
browsable tasks run reddit-search --input '{"query":"machine learning"}'
browsable tasks run reddit-search --query "machine learning" --limit 25
browsable tasks run-sync reddit-search --input '{"query":"machine learning"}'
browsable tasks inputs youtube-video
browsable tasks create --url https://example.com/products
browsable tasks create-and-run --url https://example.com/products

Upgrade an existing global installation with:

npm install -g @browsable-app/cli@latest
browsable --version

The CLI checks for a new release at most once every 24 hours and prints the upgrade command when one is available. Set BROWSABLE_CLI_UPDATE_CHECK=0 to disable this check.

For CI, set BROWSABLE_API_KEY or store a key with:

browsable auth set-key

On macOS the CLI stores API keys in Keychain when possible. Other platforms, or keychain failures, fall back to ~/.config/browsable/config.json with restrictive file permissions.

Browser login grants only the scopes requested by the CLI. Machine-key administration is intentionally excluded by default; request it explicitly with browsable login --scope tasks.read keys.manage and approve the sensitive access checkbox in the browser.

By default the CLI uses the production Browsable services:

• Dashboard: https://dashboard.browsable.app
• API: https://api.browsable.app

You normally do not need to set these. If you want to pin the production endpoints explicitly:

BROWSABLE_APP_URL=https://dashboard.browsable.app \
BROWSABLE_API_URL=https://api.browsable.app \
browsable login