Toolkit Integration for Pi

The toolkit plugin provides 9 agents, 20 commands, and 2 skills for multi-agent orchestration, TDD workflows, and advanced productivity.

Quick Reference

# From Pi:
/toolkit-update

# Or from shell:
bash ~/.pi/agent/scripts/sync-toolkit.sh

Component	Path
Agents	`~/.pi/agent/.pi/agents/toolkit/`
Commands	`~/.pi/agent/.pi/prompts/toolkit/`
Skills	`~/.pi/agent/skills/just-bash/`
Model config	`~/.pi/agent/.pi/agents/models.json`
Team config	`~/.pi/agent/.pi/agents/teams.yaml`
Sync script	`~/.pi/agent/scripts/sync-toolkit.sh`
Toolkit repo	`~/.toolkit/`

All agents are available via dispatch_agent / subagent_create and the /agents-team toolkit team.

Agent	Model	Specialty
`gemini-agent`	OpenRouter / Gemini 2.5 Flash	Large codebase analysis (1M tokens), Google Search
`cursor-agent`	Anthropic / Sonnet	Code review, refactoring, session management
`codex-agent`	Anthropic / Sonnet	Natural language to code, multi-language
`qwen-agent`	OpenRouter / Qwen3 Coder+	Agentic coding, workflow automation
`opencode-agent`	OpenRouter / Gemini 2.5 Flash	75+ AI models via OpenRouter
`groq-agent`	OpenRouter / Llama 4 Maverick	Fast inference, lightweight tasks
`crush-agent`	Anthropic / Haiku	Media compression/optimization
`droid-agent`	Anthropic / Sonnet	Enterprise code generation
`rlm-subcall`	Anthropic / Haiku	Chunk analysis helper for RLM workflow

Commands are registered by the toolkit-commands.ts extension with a toolkit- prefix.

Command	Description
`/toolkit-team`	Coordinate multi-agent team for parallel implementation
`/toolkit-haiku`	Spawn team of 10 Haiku agents managed by Opus
`/toolkit-opus`	Spawn team of 10 Opus agents managed by Opus
`/toolkit-sonnet`	Spawn team of 10 Sonnet agents managed by Opus
`/toolkit-review`	CodeRabbit review + parallel fixes + verification
`/toolkit-gherkin`	Extract business rules into Gherkin specs
`/toolkit-kiro`	Spec-driven development (requirements → design → tasks → execution)
`/toolkit-design`	Interactive design system generator (tokens, Tailwind, CSS)
`/toolkit-@implement`	Process @implement comments into documentation
`/toolkit-handbook`	Generate comprehensive project handbook

Command	Description
`/toolkit-save`	Commit, merge WIP to main, cleanup
`/toolkit-stable`	Create stable checkpoint with tags
`/toolkit-worktree`	Create isolated git worktree
`/toolkit-setup`	Initialize project context and agent-memory indexing
`/toolkit-rlm`	Recursive Language Model for large documents
`/toolkit-just-bash`	Sandboxed bash execution (read-only, no network)

Note: Compact, restore, and agent-memory are handled natively by Pi's memory-cycle.ts extension. The toolkit versions have been omitted.

Skill	CLI Tool	Description
`just-bash`	`just-bash` (Node)	Sandboxed bash execution (read-only FS, no network)

Note: agent-memory is omitted — Pi has its own memory system via memory-cycle.ts.

Feature	Pi Native	Toolkit
Compaction	`/cycle`, `/compact` (memory-cycle.ts)	Omitted — use Pi native
Restore	Auto-injected after compact	Omitted — use Pi native
Agent dispatch	`dispatch_agent` / `subagent_create`	`/toolkit-team` (orchestrated multi-agent)

toolkit-commands.ts scans ~/.pi/agent/.pi/commands/ (which symlinks to ~/.pi/agent/.pi/prompts/toolkit/) for .md files with frontmatter
Each .md is registered as a Pi slash command
Fork-mode commands spawn pi subprocesses with the command body as system prompt
Inline-mode commands inject the body as a user message with tool restrictions
agent-defs.ts scans ~/.pi/agent/.pi/agents/toolkit/ for agent definitions
Model assignments come from ~/.pi/agent/.pi/agents/models.json
Team rosters come from ~/.pi/agent/.pi/agents/teams.yaml