# Pi Configuration

Documentation for the pi coding agent installation on ](../system/index.md).
Everything here is configured locally on the workstation; the LLM providers are the
two llama.cpp servers (Dankserver, Dankclaw).

## Configuration Files

- [Pi Settings System (settings.json)](/core/settings.md) — Main `settings.json` reference. Providers, models, packages, subagent overrides.
- [Pi Models Configuration](/pi/models.md) — `models.json` reference. Provider definitions, model specs, endpoints.
- [OMP Status Line Customization](/pi/statusline.md) — How presets, composer shapes, and segment arrays actually interact; the fleet's tuned bar.

## Extensions

- [Pi Packages](/pi/packages/index.md) — Installed npm packages that extend pi functionality.
  - [Pi Peon](/pi/packages/pi-peon.md) — CESP/OpenPeon sound-pack player for lifecycle events.
  - [Pi Web Access](/pi/packages/pi-web-access.md) — Web search, URL fetching, GitHub cloning, PDF extraction, video understanding.
  - [Pi Browser Use](/packages/pi-browser-use.md) — Browser automation extension wrapping chrome-devtools-mcp with a `browser_` prefix.
  - [Pi Permission System](/packages/pi-permission-system.md) — Permission enforcement and policy configuration for subagent extensions.

## Skills

- [Pi Skills](/pi/skills.md) — Installed agent skills. Symlinked from `~/.agents/skills/` and `~/.pi/agent/skills/`.

## Subagent Architecture

- [Pi Subagents](/pi/packages/pi-subagents.md) — Core subagent delegation system. Chains, parallel execution, TUI clarification.

## Architecture

```mermaid
graph TD
    A[Pi TUI] --> B[settings.json]
    A --> C[models.json]
    B --> D[Default Provider: llamacpp]
    B --> E[Default Model: frank-default-large]
    B --> F[Packages]
    B --> G[Subagent Overrides: local frank models]
    F --> H[pi-peon]
    F --> I[pi-web-access]
    F --> J[pi-browser-use]
    F --> K[pi-permission-system]
    G --> L[Small: scout, researcher]
    G --> M[Large: planner, worker, reviewer, oracle, context-builder]
    L --> N[dankserver 192.168.0.235:7770]
    M --> O[dankclaw 192.168.0.143:7770]
```

## Note on the Live Default

In the pi era, `models.json` defined the live provider set: the main session
provider was `llamacpp` with default model `frank-default-large` (Dankclaw);
subagents defaulted to `frank-default-small` (Dankserver); larger roles mapped
to `frank-default-large`. Two scopes owned settings: the user
`~/.pi/settings.json` (main → Dankclaw/large) and the project
`/home/dank/.pi/agent/settings.json` (main → Dankserver/small); when they
disagreed, the project-scope file won for the agent's own main session.

> **Note:** This documentation describes the pi-coding-agent harness (config
> format, packages, skill system) as general reference material. The live
> harness is OMP at `~/.omp/`; OMP-managed skills live in
> `~/.omp/agent/managed-skills/`.