Pi Orchestrator 🤖🚀

Pi Orchestrator is a next-generation agentic extension for Pi Agent Coder. It transforms your terminal into an autonomous ecosystem led by a single Master Orchestrator that dynamically utilizes specialized skills to ensure a professional, end-to-end development lifecycle.

🌟 Key Features

• Master Orchestrator: A single, rational entity that manages the entire project lifecycle. No more switching roles—just intelligent, context-aware execution.
• Skill-Based Orchestration: The agent dynamically consults specialized skills (Architecture, Planning, Security, DevOps, Performance, etc.) based on the current task requirements.
• Self-Questioning & Reasoning: Built-in critical directives force the agent to analyze, question, and verify every major decision before execution, virtually eliminating hallucinations.
• Centralized "Ground Truth": All reports (QA, Security, Performance) are merged directly into plan/plan.md. This unified document feeds the plan/task.md for a streamlined workflow.
• Dynamic Session-Start Intelligence: Detects non-empty projects on session start and offers a full context analysis to synchronize your documentation and plans.
• Sleek TUI Interface:
  • Collapsible Sidebar: A real-time, debounced task list that updates as you work.
  • Zero Noise: Minimalist UI that keeps you focused on the code.
• Hardened Search: Integrated playwright_search tool for autonomous, secure web research.

🛠 Installation

Setup

Install the extension globally via npm:

npm install -g pi_orchestator

Configure Pi

Add the package to your Pi Agent's settings.json:

{
  "packages": [
    "npm:pi_orchestator"
  ]
}

Restart your Pi Agent. The Orchestrator will activate automatically!

⌨️ Shortcuts

• Alt+T: Toggle the Task List sidebar visibility.

🔄 Autonomous Workflow

1. Project Survey: Start a session in a non-empty project, and the Orchestrator will offer to analyze your codebase and update the doc/ and plan/ folders.
2. Unified Planning: All architectural decisions and audit findings are documented in plan/plan.md.
3. Task Assignment: Tasks are derived directly from the unified plan and tracked in plan/task.md.
4. Skill Execution: As tasks are tackled, the agent pulls in relevant skills (e.g., Security, Architecture) to ensure high-quality implementation.
5. Final QA & Security: Before marking the last task as completed, the Orchestrator performs a global audit (logged in plan.md) and regression test.
6. Next Steps: Once all tasks are [x], the agent provides a final report and waits for the next feature request.

📁 Project Structure

The orchestrator manages these folders in your active project:

• plan/: Unified plans/reports (plan.md) and task lists (task.md).
• doc/: Professional documentation (architecture/, modules/, api/, adr/).

📜 License

This project is licensed under the MIT License.