Configs and skills for Pi, OpenCode, and Codex. A TypeScript linker reads dotfiles.json and symlinks them into $HOME.
| Area | Path | Role |
|---|---|---|
| Linker | src/, dotfiles.json | Symlinks repo files to home paths from the manifest |
| Shared skills | dotfiles/agents/ | Skills linked to ~/.agents |
| OpenCode | dotfiles/opencode/ | Config and TUI settings (~/.config/opencode) |
| Codex | dotfiles/codex/ | Config (~/.codex) |
| Pi | dotfiles/pi/ | Settings, keybindings, and TypeScript extensions (~/.pi/agent) |
| Domain docs | CONTEXT.md, docs/adr/ | Vocabulary and ADRs, mostly for Pi extensions |
Most of the custom TypeScript is in Pi extensions: quota, auto-continue, model routing, TUI footer, web tools, and related pieces. OpenCode and Codex get the same shared skills through that linker.
dotfiles.json # link manifest
dotfiles/
agents/ # shared skills → ~/.agents
opencode/ # → ~/.config/opencode
codex/ # → ~/.codex
pi/ # → ~/.pi/agent
src/ # TypeScript linker
docs/adr/ # architecture decisions
CONTEXT.md # domain vocabulary
Node.js >=22.12.0.
npm install
npm run linknpm test
npm run lint
npm run typecheck