My personal pi configuration — agents, skills, extensions, and prompts that shape how pi works for me.
Clone this repo directly to ~/.pi/agent/ — pi auto-discovers everything from there (extensions, skills, agents, AGENTS.md, mcp.json). No symlinks, no manual wiring.
# 1. Install pi (https://github.com/badlogic/pi)
# 2. Clone this repo as your agent config
mkdir -p ~/.pi
git clone git@github.com:HazAT/pi-config ~/.pi/agent
# 3. Run setup (installs packages + extension deps)
cd ~/.pi/agent && ./setup.sh
# 4. Add your API keys to ~/.pi/agent/auth.json
# 5. Restart picd ~/.pi/agent && git pullThis config uses subagents — visible pi sessions spawned in cmux terminals. Each subagent is a full pi session with its own identity, tools, and skills. The user can watch agents work in real-time and interact when needed.
- Subagents — visible cmux terminals running pi. Autonomous agents self-terminate via
subagent_done. Interactive agents wait for the user. - Agent definitions (
agents/*.md) — one source of truth for model, tools, skills, and identity per role. - Plan workflow —
/planspawns an interactive planner subagent, then orchestrates workers and reviewers. - Iterate pattern —
/iterateforks the session into a subagent for quick fixes without polluting the main context.
Specialized roles with baked-in identity, workflow, and review rubrics.
| Agent | Model | Purpose |
|---|---|---|
| planner | Opus 4.6 | Interactive brainstorming — clarify, explore, validate design, write plan, create todos |
| scout | Haiku 4.5 | Fast codebase reconnaissance — gathers context without making changes |
| worker | Sonnet 4.6 | Implements tasks from todos, commits with polished messages |
| reviewer | Opus 4.6 | Reviews code for quality, security, correctness (review rubric baked in) |
| researcher | Sonnet 4.6 | Deep research using parallel.ai tools + Claude Code for code analysis |
| visual-tester | Sonnet 4.6 | Visual QA — navigates web UIs via Chrome CDP, spots issues, produces reports |
| autoresearch | Opus 4.6 | Autonomous experiment loop — runs, measures, and optimizes iteratively |
Loaded on-demand when the context matches.
| Skill | When to Load |
|---|---|
| commit | Making git commits (mandatory for every commit) |
| code-simplifier | Simplifying or cleaning up code |
| frontend-design | Building web components, pages, or apps |
| github | Working with GitHub via gh CLI |
| iterate-pr | Iterating on a PR until CI passes |
| learn-codebase | Onboarding to a new project, checking conventions |
| session-reader | Reading and analyzing pi session JSONL files |
| skill-creator | Scaffolding new agent skills |
| cmux | Managing terminal sessions via cmux |
| presentation-creator | Creating data-driven presentation slides |
| add-mcp-server | Adding MCP server configurations |
| Extension | What it provides |
|---|---|
| answer/ | /answer command + Ctrl+. — extracts questions into interactive Q&A UI |
| claude-tool/ | claude tool — invoke Claude Code for autonomous tasks |
| cmux/ | cmux integration — notifications, sidebar, workspace tools |
| cost/ | /cost command — API cost summary |
| execute-command/ | execute_command tool — lets the agent self-invoke slash commands |
| todos/ | /todos command + todo tool — file-based todo management |
| watchdog/ | Monitors agent behavior |
| Command | Description |
|---|---|
/plan <description> |
Start a planning session — spawns planner subagent, then orchestrates execution |
/subagent <agent> <task> |
Spawn a subagent (e.g., /subagent scout analyze the auth module) |
/iterate [task] |
Fork session into interactive subagent for quick fixes |
/answer |
Extract questions into interactive Q&A |
/todos |
Visual todo manager |
/cost |
API cost summary |
Installed via pi install, managed in settings.json.
| Package | Description |
|---|---|
| pi-interactive-subagents | Subagent tools + /plan, /subagent, /iterate commands |
| pi-parallel | Parallel web search, extract, research, and enrich tools |
| pi-smart-sessions | AI-generated session names |
| pi-autoresearch | Autonomous experiment loop with dashboard |
| pi-mcp-adapter | MCP server integration |
| glimpse | Native macOS UI — dialogs, forms, visualizations |
| chrome-cdp-skill | Chrome DevTools Protocol CLI for visual testing |
Extensions from mitsuhiko/agent-stuff: answer, todos
Skills from mitsuhiko/agent-stuff: commit, github
Skills from getsentry/skills: code-simplifier