This repository provides a comprehensive configuration for the pi agent framework, enhancing it with specialized subagents, skills, and extensions. It targets developers and power users seeking to automate complex coding tasks, offering a structured, observable, and interactive AI coding assistant for planning, implementation, review, and research.

How It Works

Core architecture centers on pi subagents, distinct pi sessions within cmux terminals. Each subagent embodies a specialized role (planner, scout, worker) defined by model, tools, and skills. This modularity enables parallel execution, real-time observation, and interactive intervention. Workflows like /plan orchestrate subagents; /iterate patterns facilitate focused task refinement.

Quick Start & Requirements

• Install: Clone this repo directly to ~/.pi/agent/.
• Prerequisites: pi framework (https://github.com/badlogic/pi) installed. API keys required in ~/.pi/agent/auth.json.
• Setup: Run ./setup.sh in the cloned directory. Restart pi.
• Docs: pi framework: https://github.com/badlogic/pi

Highlighted Details

• Subagent Architecture: Specialized, observable, interactive AI agents (planner, scout, worker, reviewer, researcher, visual-tester, autoresearch) run in separate cmux terminals.
• Skillset: On-demand skills cover Git commits, code simplification, frontend design, GitHub interaction, PR iteration, codebase learning, and more.
• Command Interface: High-level commands include /plan for workflow initiation, /subagent for direct agent spawning, and /iterate for focused task refinement.
• Integrated Tools: Packages provide interactive subagents, parallel web research, autonomous research loops, macOS UI (glimpse), and Chrome DevTools Protocol for visual testing.

Maintenance & Community

This appears to be a personal configuration, sourcing components from projects like mitsuhiko/agent-stuff. No specific community links or maintenance details are provided.

Licensing & Compatibility

The README does not explicitly state a license for this configuration. It relies on the underlying pi framework and potentially other components. Commercial use requires verifying all integrated licenses.

Limitations & Caveats

Presented as a personal configuration, it may be tailored to specific workflows. Setup requires prior pi installation and API key management. No specific limitations or alpha status are mentioned.