Files

T

Frank c3f30bdbd0 kb: retire pi-installation association (OMP is the primary harness)

Purge live-state claims that ~/.pi is our harness; keep general
pi documentation in omp-docs/ and dated historical records.

- README.md: single config source; Legacy Notes reworded
- AGENTS.md: drop 'like ~/.pi did' framing
- APPEND_SYSTEM.md: okf-spec -> omp-docs/references/okf-spec.md
- dotfiles/zsh/.zshrc: systemprompt alias -> APPEND_SYSTEM.md
- managed skill llm-fleet-model-swap + model_config_sync skill:
  single-source models.yml; validation script YAML-only
- memories (MEMORY.md, memory_summary.md, learned.md): single source
- omp-docs: .okf root -> ~/.omp/omp-docs; de-live pi-era claims in
  pi/index.md, pi-web-access.md, engineering/agents-files.md

2026-09-17 19:24:02 -07:00

2.7 KiB

Raw Blame History

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

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

2.7 KiB Raw Blame History