ROACH PI enhances the pi coding agent by enforcing strict engineering discipline and multi-agent orchestration. It transforms standard coding sessions into inspectable, verifiable engineering loops, benefiting pi users seeking structured development workflows.

How It Works

This extension suite integrates eight core components into the pi agent to create a disciplined engineering loop. It begins with /clarify to resolve ambiguity, followed by /goal for durable, verifier-guarded execution where completion requires a PASS from the verifier. A /review command provides rapid, single-pass code analysis. The system supports flexible subagent orchestration (single, parallel, chain, async) for delegating tasks. Key features include FFF Search for git-aware file/content discovery, an integrated LSP client offering IDE-like code intelligence for over 40 languages, MCP Adapter for efficient access to Model Context Protocol servers, workspace memory for recalling findings, and session loops for recurring tasks. Nested AGENTS.md allows local conventions, while code previews render tool calls with syntax highlighting.

Quick Start & Requirements

• Installation: Run pi install git:github.com/tmdgusya/roach-pi, then execute /setup within pi.
• Prerequisites: pi coding agent (version 0.72.x).
• Dependencies: Supports 40+ language servers out-of-the-box. Bundled dependencies include pi-lsp-client, pi-mcp-adapter, @code-yeongyu/pi-nested-agents-md, and shiki.
• Setup: /setup configures quietStartup: true in ~/.pi/agent/settings.json.
• Note: Remove the superpowers skill before installation to avoid potential skill name collisions.

Highlighted Details

• Implements a disciplined engineering loop via eight bundled extensions.
• Features /clarify for ambiguity resolution and /goal for verifier-guarded durable execution.
• Provides robust subagent orchestration and integrated LSP code intelligence.
• Includes git-aware FFF Search and efficient MCP tool access.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or project health signals are present in the README. Contribution guidelines are available in CONTRIBUTING.md.

Licensing & Compatibility

• License: MIT.
• Compatibility: The MIT license generally permits commercial use and integration with closed-source projects without significant restrictions.

Limitations & Caveats

The superpowers skill must be uninstalled prior to ROACH PI installation due to potential skill name conflicts. Team mode is opt-in and requires specific environment variable configuration (PI_ENABLE_TEAM_MODE=1). Development setup instructions are detailed per extension rather than a unified root command.