# Configuration Reference

All config files live in `~/.pi/agent/`. Files marked _git-ignored_ contain local state and are not tracked.

## settings.json

Model, theme, packages, and runtime behavior:

```json
{
  "defaultProvider": "anthropic",
  "defaultModel": "claude-opus-4-6",
  "defaultThinkingLevel": "high",
  "theme": "riced",
  "packages": [
    "npm:pi-mcp-adapter",
    "npm:pi-powerline-footer",
    "npm:pi-subagents",
    "npm:pi-web-access",
    "npm:pi-model-aware-compaction",
    "npm:pi-lens"
  ]
```

See the full file for compaction, retry, and other options.

## mcp.json

MCP server definitions. Currently configures [Playwright MCP](https://playwright.dev/mcp) for browser automation:

```json
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--config",
        "~/.pi/agent/playwright-mcp.json"
      ],
      "lifecycle": "lazy"
    }
  }
}
```

See [browser-mcp.md](browser-mcp.md) for browser selection and profile options.

## playwright-mcp.json

Browser config for Playwright MCP. Default uses Playwright's bundled Chromium:

```json
{
  "browser": {
    "browserName": "chromium"
  }
}
```

See [browser-mcp.md](browser-mcp.md) for Chrome, Firefox, Edge, Brave, and remote debugging setups.

## local-endpoints.json _(git-ignored)_

Static LLM backend config. A single llamacpp endpoint at a fixed IP:

```json
{
  "endpoints": [
    {
      "name": "cloud",
      "backend": "llamacpp",
      "url": "http://<ip>:<port>"
    }
  ]
}
```

The backend becomes available as provider `llamacpp-<name>` (e.g. `llamacpp-cloud`).

## auth.json _(git-ignored)_

LLM provider credentials, managed via `/login` inside pi. Supports OAuth (Claude Pro/Max, ChatGPT Plus) and API keys (Anthropic, OpenAI, OpenRouter, Google, and [more](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/providers.md)).

## Other Runtime Files _(git-ignored)_

| File                | Purpose                   |
| ------------------- | ------------------------- |
| `sessions/`         | Session history and logs  |
| `run-history.jsonl` | Subagent run history      |
| `mcp-cache.json`    | MCP server metadata cache |

## Theme

Ships with `riced` — a custom color theme in `themes/riced.json`. Set via `"theme": "riced"` in `settings.json`.
