Personal configuration for pi-coding-agent, tuned for a locally-hosted DeepSeek V4 Flash backend.
Cloned to ~/dotpi/ and symlinked into ~/.pi/agent/ via install.sh. Editing files here edits them live in pi.
| File | Symlinks to | Purpose |
|---|---|---|
AGENTS.md |
~/.pi/agent/AGENTS.md |
Global context, loaded as a user-message block every session |
APPEND_SYSTEM.md |
~/.pi/agent/APPEND_SYSTEM.md |
Behavior rules, appended to pi's built-in system prompt |
settings.json |
~/.pi/agent/settings.json |
Pi runtime settings (retry, thinking level) |
models.json |
~/.pi/agent/models.json |
Provider/model registry |
skills/ |
~/.pi/agent/skills/ |
User-level slash commands |
prompts/ |
~/.pi/agent/prompts/ |
Reusable prompt templates |
SYSTEM.md is deliberately not included; we want pi's defaults intact and only append to them.
Setup tips, host tuning, and supervision workflow notes that aren't part of the live config live in notes/.
Pi agents are driven and monitored from a separate orchestrator session using Agent of Empires (aoe), which manages each task as a tmux + Docker sandbox with its own pi process and git worktree. The orchestrator polls aoe session capture for state transitions and intervenes only on destructive actions or hard failure. See notes/supervision.md for the full topology and failure modes.
PRs authored by the pi+ds4 setup land with a Co-Authored-By: DeepSeek V4 Flash <noreply@deepseek.com> trailer and a 🤖 Generated by DeepSeek V4 Flash running on ds4 footer in the body. That makes them searchable.
Public PRs across the mozilla-ai org (Clawbolt OSS + premium):
The setup also drives work in private repos that I can't link here. The public list is a sample, not the whole picture.
git clone git@github.com:njbrake/dotpi.git ~/dotpi
cd ~/dotpi && ./install.shInitial config copied from mitsuhiko/pi-ds4's defaults. Diverges where our usage diverges: no extension-managed lifecycle (we run ds4-server directly), and tuned for our specific hardware/network setup. See inline comments in models.json and settings.json for the rationale on individual values.
- antirez/ds4 — local LLM server
- mitsuhiko/pi-ds4 — reference pi extension
- badlogic/pi-mono — pi source