This repository, disler/pi-vs-claude-code, provides a collection of customized Pi Coding Agent instances. It aims to demonstrate how developers can build alternatives and extensions to leading closed-source agents like Claude Code, focusing on UI customization, agent orchestration, safety auditing, and cross-agent integration. The project targets developers and power users interested in agentic coding, offering a flexible, open-source approach to agent development and deployment.

How It Works

Pi Agent features a modular architecture with a CLI and a robust extension system. It enables multi-agent workflows through the Subagent Widget for background task offloading, Agent Teams for delegating tasks to specialist agents defined in YAML, and Agent Chains for sequential processing where outputs feed into subsequent steps. Safety is enhanced via the Damage Control extension, which intercepts bash commands and file operations against configurable rules to prevent destructive actions. This design prioritizes extensibility and fine-grained control over agent behavior.

Quick Start & Requirements

• Prerequisites: Bun (≥ 1.3.2), just, Pi Coding Agent CLI.
• API Keys: Required for providers like OpenAI, Anthropic, Google, OpenRouter. Must be set in the shell environment or a .env file.
• Installation: bun install.
• Running: Use just pi for a basic Pi instance, or pi -e <extension_name>.ts for specific extensions. just recipes offer pre-configured combinations (e.g., just ext-damage-control).
• Resources: Links to Pi Docs, Pi Providers docs.

Highlighted Details

• Extensive Extension System: Features numerous extensions for UI customization (pure-focus, theme-cycler), agent orchestration (agent-team, agent-chain, subagent-widget), productivity (tilldone, purpose-gate), and safety (damage-control).
• Multi-Agent Orchestration: Supports dispatcher-based teams and sequential agent chains. The pi-pi meta-agent builds extensions using specialized agents, leveraging Firecrawl with curl fallback for dynamic data ingestion.
• Safety Auditing: The damage-control extension provides real-time interception of bash commands and file access based on configurable rules to prevent security risks.
• Claude Code Comparison: Detailed comparisons (COMPARISON.md, PI_VS_OPEN_CODE.md) highlight differences in hooks, event lifecycles, and UI customization between Pi Agent and Claude Code.

Maintenance & Community

• Mentions Mario (Creator of Pi Coding Agent) and IndyDevDan (YouTube channel for agentic coding).
• No explicit links to Discord/Slack, roadmap, or sponsorships are provided in the README.

Licensing & Compatibility

• The README does not explicitly state a software license.
• Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The project focuses on showcasing Pi Agent's capabilities as an alternative to closed-source leaders, implying it may be a newer or less mature ecosystem in certain aspects. Specific limitations or known bugs are not detailed in the provided README excerpt. Users are required to manage API keys for various providers.