Files
command-center/omp-docs/pi/index.md
T
Frank 689228e60d docs: purge the retired workstation from the knowledge base
Second half of the purge (the first covered the persona, AGENTS.md, README.md,
and the distillation of the per-host pages). Every remaining identifier is
gone: hostname, both LAN addresses, and the Wi-Fi SSID.

34 count-checked substitutions across 22 files — indexes, tool/research pages,
the inventory census, the changelog, one generated HTML report, and five
managed skills. Facts kept, names dropped: a history entry keeps its four-page
listing as a nameless summary, the syslog excerpts keep every timestamp and
line, and the census keeps the .zcompdump rows (the zsh version stamps are the
useful part, the hostname was not).

Deliberately unchanged: install.sh's --host case list and the
packages/<hostname>.pkgs filename, where the hostname is the lookup key.

Left out of scope by Frank's call: agent/memories/** — past-session records the
learn pipeline rewrites.

kb-lint: 0 violations. Residual grep for the hostname, its two IPs, and the
SSID across omp-docs/ and agent/managed-skills/: no hits.
2026-09-28 16:37:38 -07:00

62 lines
2.7 KiB
Markdown

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