Frank
02883d3ed2
Copy of the legacy ~/.pi/agent/docs tree rebuilt as the command-center knowledge base: concept files promoted to path identity, index listings stripped of frontmatter, all wikilinks/relative links resolved, every checkable claim verified against the live fleet (Dankserver = Ryzen 7 7700X + RTX 3090; Strix Halo is Dankclaw), unverifiable claims tagged. kb-lint exits 0.
60 lines
3.0 KiB
Markdown
60 lines
3.0 KiB
Markdown
# 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)](/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.
|
|
|
|
## 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
|
|
|
|
`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/`.
|