HazAT / pi-config

Pi Config My personal pi configuration — agents, skills, extensions, and prompts that shape how pi works for me. Setup Clone this repo directly to — pi auto-discovers everything from there (extensions, skills, agents, AGENTS.md, mcp.json). No symlinks, no manual wiring. Fresh machine Updating --- Architecture This 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. Key Concepts • **Subagents** — visible cmux terminals running pi. Autonomous agents self-terminate via . Interactive agents wait for the user. • **Agent definitions** ( ) — one source of truth for model, tools, skills, and identity per role. • **Plan workflow** — spawns an interactive planner subagent, then orchestrates workers and reviewers. • **Iterate pattern** — forks the session into a subagent for quick fixes without polluting the main context. --- Agents 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 | Skills 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 CLI | | **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 | Extensions | Extension | What it provides | |-----------|------------------| | **subagents/** | tool + , , commands — spawns agents in cmux terminals | | **answer.ts** | command + — extracts questions into interactive Q&A UI | | **claude-tool/** | tool — invoke Claude Code for autonomous tasks | | **execute-command.ts** | tool — lets the agent self-invoke slash commands | | **session-artifacts.ts** | tool — session-scoped artifact storage | | **todos.ts** | command + tool — file-based todo management | | **cost.ts** | command — API cost summary | | **cmux/** | cmux integration — notifications, sidebar, workspace tools | | **ghostty.ts** | Ghostty terminal title + progress bar integration | | **watchdog.ts** | Monitors agent behavior | Commands | Command | Description | |---------|-------------| | | Start a planning session — spawns planner subagent, then orchestrates execution | | | Spawn a subagent (e.g., ) | | | Fork session into interactive subagent for quick fixes | | | Extract questions into interactive Q&A | | | Visual todo manager | | | API cost summary | Packages Installed via , managed in . | Package | Description | |---------|-------------| | pi-parallel | Parallel web search, extract, research, and enrich tools | | pi-smart-sessions | AI-generated session names | | glimpse | Native macOS UI — dialogs, forms, visualizations | | chrome-cdp-skill | Chrome DevTools Protocol CLI for visual testing | --- Credits Extensions from mitsuhiko/agent-stuff: , Skills from mitsuhiko/agent-stuff: , Skills from getsentry/skills: