Frank
ae82aa00e4
Census against serverAppConfigs-docs + read-only ssh probes on both boxes (2026-10-18). Corrections to OURS, flags only for THEIRS: - Hardware drift: RTX 3090 moved dankserver->dankclaw 2026-09; dankserver now 2x Radeon AI PRO R9700 (Ryzen 7 7700X stays), 246 GiB RAM, no swap; dankclaw 121 GiB RAM + 64 GiB swap. Served: frank-archon radiance TP=2 (:7770 dankserver), frank-dragoon halogen NATIVE v2 (:7770 dankclaw iGPU), frank-zealot llama.cpp PrismML Ternary-Bonsai-2-27B PQ2_0 (:7771 dankclaw, 3090). Kernel 7.0.0-38 both; dankclaw :7770 no auth. - Gitea: gitea-caddy quadlet retired (fleet Caddy fronts the domain); data tree moved to /home/dank/Containers/gitea/ (2026-09-01 standard), /opt/gitea is a do-not-use leftover; LAN IP + live domain. - pi-era pages (core/settings, pi/models + role tables) demarcated as ARCHIVE with banners; llama-cpp fleet note modernized. - AGENTS.md machine-facts table corrected (it still routed prod warnings at frank-default-large). Their-side staleness flagged in the changelog entry for the operator, not edited: OMP Harness thresholdPercent 70 (live is 95), Ubuntu 24.04 OS table, 2026-09-03 stack mapping, superseded pi-KB backlink. Refs #5
67 lines
3.2 KiB
Markdown
67 lines
3.2 KiB
Markdown
# Pi Configuration
|
|
|
|
> **Archive note (2026-10-18).** Most pages in this directory document the retired
|
|
> **pi** harness (settings.json / models.json, `frank-default-*` endpoints, verified
|
|
> 2026-08-28). The live harness is **omp** — its config is `agent/config.yml` +
|
|
> `agent/models.yml` in this repo, the current fleet endpoints are on
|
|
> [System hosts](/system/index.md), and omp-specific knowledge lands in pages like
|
|
> [OMP Status Line Customization](/pi/statusline.md) below. Read pi pages as
|
|
> historical records, not current state.
|
|
|
|
## 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/`.
|