> ## Documentation Index
> Fetch the complete documentation index at: https://piyushvyas.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`.

<CodeGroup>
  ```bash View all settings theme={null}
  bap config
  ```

  ```bash Set default browser theme={null}
  bap config browser firefox
  ```

  ```bash Disable headless mode theme={null}
  bap config headless false
  ```

  ```bash Set default timeout theme={null}
  bap config timeout 60000
  ```
</CodeGroup>

<ParamField path="key" type="string">
  Configuration key to set. Omit to view all settings.
</ParamField>

<ParamField path="value" type="string">
  Value to set for the key.
</ParamField>

### 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.

<CodeGroup>
  ```bash Auto-detect and install to all agents theme={null}
  bap install-skill
  ```

  ```bash Preview what would be installed theme={null}
  bap install-skill --dry-run
  ```

  ```bash Install globally theme={null}
  bap install-skill --global
  ```

  ```bash Install to current project theme={null}
  bap install-skill --project
  ```
</CodeGroup>

<ParamField path="--dry-run" type="flag">
  Preview what would be installed without making changes.
</ParamField>

<ParamField path="--global" type="flag">
  Install to global agent configurations.
</ParamField>

<ParamField path="--project" type="flag">
  Install to the current project directory.
</ParamField>

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.

```bash theme={null}
bap skill init
```

## Global Flags

These flags can be used with any BAP command:

<ParamField path="-s" type="string">
  Named session. Commands with the same `-s` value share a browser context.
</ParamField>

<ParamField path="-p, --port" type="number" default="9222">
  Server port for the BAP daemon.
</ParamField>

<ParamField path="-b, --browser" type="string" default="chrome">
  Browser to use: `chrome`, `chromium`, `firefox`, `webkit`, `edge`.
</ParamField>

<ParamField path="--headless" type="flag">
  Run browser in headless mode. Useful for CI or background runs.
</ParamField>

<ParamField path="--no-headless" type="flag">
  Show the browser window (default behavior).
</ParamField>

<ParamField path="--profile" type="string">
  Chrome profile directory. Default: auto-detect.
</ParamField>

<ParamField path="--no-profile" type="flag">
  Launch a fresh browser without any user profile.
</ParamField>

<ParamField path="--stealth" type="flag">
  Reduce bot detection fingerprint.
</ParamField>

<ParamField path="--connect" type="flag">
  Auto-attach to a running Chrome instance.
</ParamField>

<ParamField path="--format" type="string" default="agent">
  Output format: `pretty` (colored, for TTY), `json` (machine-readable), `agent` (concise markdown).
</ParamField>

<ParamField path="--observe" type="flag">
  Fuse observation with `goto` or `act` commands.
</ParamField>

<ParamField path="--diff" type="flag">
  Incremental observation (only changes since last observe).
</ParamField>

<ParamField path="--tier" type="string">
  Response tier for observation: `full`, `interactive`, `minimal`.
</ParamField>

<ParamField path="--max" type="number" default="50">
  Maximum number of elements for observation.
</ParamField>

<ParamField path="--timeout" type="number" default="30000">
  Command timeout in milliseconds.
</ParamField>

<ParamField path="-v, --verbose" type="flag">
  Enable verbose output for debugging.
</ParamField>

<ParamField path="-h, --help" type="flag">
  Show help text.
</ParamField>

<ParamField path="-V, --version" type="flag">
  Show BAP CLI version.
</ParamField>