Configuration

Configure BAP CLI defaults, install skills to AI agents, and set global options.

Configuration

bap config

View and set persistent configuration options. Settings are stored in ~/.bap/config.json.

View all settings

bap config

key · string

Configuration key to set. Omit to view all settings.

value · string

Value to set for the key.

Available Settings

Key	Default	Description
browser	chrome	Default browser: chrome, chromium, firefox, webkit, edge
headless	false	Run browser in headless mode
timeout	30000	Default timeout in milliseconds
port	9222	Server port

install-skill

Install the BAP skill file to detected AI coding agents.

Auto-detect and install to all agents

bap install-skill

--dry-run · flag

Preview what would be installed without making changes.

--global · flag

Install to global agent configurations.

--project · flag

Install to the current project directory.

Supports 13 AI coding agent platforms: Claude Code, Codex CLI, Gemini CLI, Cursor, GitHub Copilot, Windsurf, Roo Code, Amp, Deep Agents, OpenCode, and more.

skill init

Install skill files to the current project directory.

bap skill init

Global Flags

These flags can be used with any BAP command:

-s · string

Named session. Commands with the same -s value share a browser context.

-p, --port · number · default: "9222"

Server port for the BAP daemon.

-b, --browser · string · default: "chrome"

Browser to use: chrome, chromium, firefox, webkit, edge.

--headless · flag

Run browser in headless mode. Useful for CI or background runs.

--no-headless · flag

Show the browser window (default behavior).

--profile · string

Chrome profile directory. Default: auto-detect.

--no-profile · flag

Launch a fresh browser without any user profile.

--stealth · flag

Reduce bot detection fingerprint.

--connect · flag

Auto-attach to a running Chrome instance.

--format · string · default: "agent"

Output format: pretty (colored, for TTY), json (machine-readable), agent (concise markdown).

--observe · flag

Fuse observation with goto or act commands.

--diff · flag

Incremental observation (only changes since last observe).

--tier · string

Response tier for observation: full, interactive, minimal.

--max · number · default: "50"

Maximum number of elements for observation.

--timeout · number · default: "30000"

Command timeout in milliseconds.

-v, --verbose · flag

Enable verbose output for debugging.

-h, --help · flag

Show help text.

-V, --version · flag

Show BAP CLI version.