command-center/omp-docs/pi/index.md

Pi Configuration

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

Configuration Files

• Pi Settings System (settings.json) — Main settings.json reference. Providers, models, packages, subagent overrides.
• Pi Models Configuration — models.json reference. Provider definitions, model specs, endpoints.

Extensions

• Pi Packages — Installed npm packages that extend pi functionality.
  • Pi Peon — CESP/OpenPeon sound-pack player for lifecycle events.
  • Pi Web Access — Web search, URL fetching, GitHub cloning, PDF extraction, video understanding.
  • Pi Browser Use — Browser automation extension wrapping chrome-devtools-mcp with a browser_ prefix.
  • Pi Permission System — Permission enforcement and policy configuration for subagent extensions.

Skills

• Pi Skills — Installed agent skills. Symlinked from ~/.agents/skills/ and ~/.pi/agent/skills/.

Subagent Architecture

• Pi Subagents — Core subagent delegation system. Chains, parallel execution, TUI clarification.

Architecture

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

models.json defines the live provider set. The main session provider is llamacpp; the default model is frank-default-large (Dankclaw). Subagents default to the local provider with subagents.defaultModel = frank-default-small (Dankserver); larger roles map to frank-default-large. Two scopes own settings: the user ~/.pi/settings.json (main → Dankclaw/large) and the project /home/dank/.pi/agent/settings.json (main → Dankserver/small). When the two disagree, the project-scope settings.json in the agent home wins for the agent's own main session; the user-scope file governs the interactive pi session.

Note: This documentation describes the pi-coding-agent era. The system has since migrated to the OMP harness era. Configuration is now at ~/.omp/agent/config.yml and ~/.omp/agent/models.yml (imported from ~/.pi/agent/models.json). Legacy ~/.pi/settings.json and ~/.pi/agent/settings.json remain as pi-era artifacts. New OMP-managed skills live in ~/.omp/agent/managed-skills/ alongside the legacy symlinked skills at ~/.pi/agent/skills/ → ~/.agents/skills/.