Pi Config

Personal global pi configuration. Clone it to ~/.pi/agent/ to get the same agents, skills, prompt templates, local extensions, model defaults, and package configuration.

This config is now Solo-native and intentionally small: orchestration goes through Solo subagents, Solo scratchpads, and Solo todos; only the local extensions that are still useful remain.

Setup

mkdir -p ~/.pi
git clone [email protected]:HazAT/pi-config ~/.pi/agent
cd ~/.pi/agent && ./setup.sh

Add credentials to ~/.pi/agent/auth.json and restart pi. If you use the optional OpenRouter model in models.json, also provide OPENROUTER_API_KEY in your environment.

setup.sh expects this repo to live at ~/.pi/agent/ and installs the configured packages.

Defaults

Setting	Value
Default provider	openai-codex
Default model	gpt-5.5
Default thinking level	xhigh
Enabled models	anthropic/claude-opus-4-7, openai-codex/gpt-5.5
Installed packages	git:github.com/pasky/chrome-cdp-skill, git:github.com/HazAT/pi-parallel

Custom provider definitions live in models.json:

• lmstudio — local Gemma 4 26B A4B via LM Studio.
• openrouter — Poolside Laguna M.1 free model via OpenRouter.

Architecture

• Solo subagents run focused roles and save artifacts to Solo scratchpads.
• Solo todos hold executable work items for workers.
• Scratchpads are the artifact channel for scout context, plans, worker results, reviews, and research.
• Prompt templates provide slash-command workflows such as /plan.
• Local extensions provide /answer, /cost, and the execute_command tool.

The old local cmux and file-based todos extensions are gone; orchestration now uses Solo directly.

Agents

Agent	Model	Purpose
planner	anthropic/claude-opus-4-6	Interactive Solo planning; clarifies intent, designs the approach, writes a plan scratchpad, and creates Solo todos
scout	anthropic/claude-haiku-4-5	Fast read-only codebase reconnaissance
worker	anthropic/claude-sonnet-4-6	Implements one Solo todo, verifies it, commits with the commit skill, saves a result scratchpad, and closes the todo
reviewer	openai-codex/gpt-5.5	Reviews changes for quality, security, and correctness
researcher	anthropic/claude-sonnet-4-6	Uses web tools and local code reading to produce sourced research
visual-tester	anthropic/claude-sonnet-4-6	Uses Chrome CDP for visual QA and scratchpad reports
handoff	Global default	Interactive fresh-session continuation agent launched by /handoff with a Solo scratchpad summary
autoresearch	anthropic/claude-opus-4-6	Runs autonomous experiment batches

Skills

Skill	When to Load
plan	Running the Solo-native planning workflow
handoff	Starting a fresh Solo Pi session from a current-session handoff scratchpad
write-todos	Writing worker-ready Solo todos from a plan
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 project and checking conventions
session-reader	Reading and analyzing pi session JSONL files
skill-creator	Creating agent skills
add-mcp-server	Adding MCP server configurations
chrome-cdp	Inspecting local Chrome tabs when explicitly approved

Removed skills: cmux, presentation-creator, and self-improve.

Prompt Templates and Local Extensions

Path	Provides
prompts/plan.md	/plan <description> Solo planning workflow
prompts/handoff.md	/handoff <new prompt> creates a handoff scratchpad and starts an interactive fresh Solo Pi session
extensions/answer/	/answer and ctrl+. interactive Q&A extraction from the last assistant message
extensions/cost/	/cost [days] API cost summary
extensions/execute-command/	execute_command tool for triggering /answer, queuing slash commands, or sending a steer message

Packages

Packages are managed in settings.json.

Package	Purpose
git:github.com/pasky/chrome-cdp-skill	Chrome DevTools Protocol CLI and skill for visual testing
git:github.com/HazAT/pi-parallel	Web search, fetch, deep research, and batch enrichment tools

Update

cd ~/.pi/agent
git pull
./setup.sh