{"id":34554218,"url":"https://github.com/apathy-ca/czarina","last_synced_at":"2026-01-19T08:03:39.533Z","repository":{"id":326996078,"uuid":"1105797418","full_name":"apathy-ca/czarina","owner":"apathy-ca","description":"🎭 Autonomous multi-agent orchestration for ANY AI coding agent - Claude Code, Aider, Cursor, API, or even humans. Deploy 2-20+ workers, walk away, return to completed features.","archived":false,"fork":false,"pushed_at":"2026-01-18T03:07:40.000Z","size":1456,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-18T14:53:56.853Z","etag":null,"topics":["ai-coding","ai-orchestration","aider","automation","autonomous","claude-code","multi-agent","orchestration"],"latest_commit_sha":null,"homepage":"https://github.com/apathy-ca/czarina","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apathy-ca.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-28T07:09:43.000Z","updated_at":"2026-01-18T03:07:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/apathy-ca/czarina","commit_stats":null,"previous_names":["apathy-ca/czarina"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/apathy-ca/czarina","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apathy-ca%2Fczarina","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apathy-ca%2Fczarina/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apathy-ca%2Fczarina/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apathy-ca%2Fczarina/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apathy-ca","download_url":"https://codeload.github.com/apathy-ca/czarina/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apathy-ca%2Fczarina/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28563240,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T03:31:16.861Z","status":"ssl_error","status_checked_at":"2026-01-19T03:31:15.069Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-coding","ai-orchestration","aider","automation","autonomous","claude-code","multi-agent","orchestration"],"created_at":"2025-12-24T08:26:56.740Z","updated_at":"2026-01-19T08:03:39.521Z","avatar_url":"https://github.com/apathy-ca.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Czarina: Multi-Agent Orchestration System\n\n**Orchestrate multiple AI coding agents working in parallel on complex software projects**\n\n[![Production Ready](https://img.shields.io/badge/status-production%20ready-green)]() [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\nCzarina enables autonomous teams of 9+ AI coding agents (Claude Code, Aider, Cursor, Kilocode, Windsurf, Cline, etc.) to collaborate on software development with 95-98% autonomy and 3-4x speedup.\n\n---\n\n## 🎯 How It Works\n\n```mermaid\ngraph TB\n    H[👤 Human\u003cbr/\u003eSets Goals] --\u003e C[🎭 Czar\u003cbr/\u003eCoordinates]\n\n    C --\u003e W1[👷 Worker 1\u003cbr/\u003eClaude Code]\n    C --\u003e W2[👷 Worker 2\u003cbr/\u003eAider]\n    C --\u003e W3[👷 Worker 3\u003cbr/\u003eCursor]\n    C --\u003e W4[👷 Worker 4\u003cbr/\u003eKilocode]\n    C --\u003e W5[👷 Worker 5\u003cbr/\u003eWindsurf]\n    C --\u003e W6[👷 Worker 6\u003cbr/\u003eCline]\n\n    D[⚡ Daemon\u003cbr/\u003eAuto-Approves] -.-\u003e|95-98%\u003cbr/\u003eautonomy| W1\n    D -.-\u003e W2\n    D -.-\u003e W3\n    D -.-\u003e W4\n    D -.-\u003e W5\n    D -.-\u003e W6\n\n    W1 --\u003e G[📦 Git\u003cbr/\u003ePull Requests]\n    W2 --\u003e G\n    W3 --\u003e G\n    W4 --\u003e G\n    W5 --\u003e G\n    W6 --\u003e G\n\n    G -.-\u003e|Review \u0026 Merge| H\n\n    M[🧠 Memory\u003cbr/\u003eLearns] -.-\u003e|Past Sessions| W1\n    M -.-\u003e W2\n    M -.-\u003e W3\n\n    R[📚 Rules\u003cbr/\u003e43K+ lines] -.-\u003e|Best Practices| W1\n    R -.-\u003e W4\n    R -.-\u003e W5\n\n    style H fill:#e8f5e9\n    style C fill:#e1f5ff\n    style D fill:#fff3e0\n    style G fill:#f3e5f5\n    style M fill:#e3f2fd\n    style R fill:#fce4ec\n```\n\n**The Flow:**\n1. **Human** sets project goals and worker roles\n2. **Czar** (AI or human) launches and monitors workers autonomously\n3. **Daemon** auto-approves file operations (95-98% autonomy)\n4. **Workers** (6+ agent types) code in parallel in isolated git worktrees\n5. **Memory** provides workers with learnings from past sessions\n6. **Rules** equip workers with 43K+ lines of best practices\n7. **Git** collects work via pull requests\n8. **Human** reviews and merges\n\n**The Czar** monitors all workers, manages the daemon, tracks token budgets, and coordinates the orchestration. Can be Claude Code, Cursor, human, or any agent. See [docs/guides/CZAR_ROLE.md](docs/guides/CZAR_ROLE.md) for details.\n\n---\n\n## 💻 Platform Requirements\n\n**Supported Platforms:**\n- Linux (Ubuntu, Debian, Fedora, etc.)\n- macOS\n- Windows via WSL (Windows Subsystem for Linux)\n\n**Required:**\n- bash shell\n- tmux (for session management)\n- git\n- Python 3.8+\n- jq (JSON processor)\n\n**Note:** Czarina cannot run natively on Windows - it requires Unix tooling (bash, tmux, git worktrees). Windows users must use WSL.\n\n---\n\n## ⚡ Quick Start\n\n```bash\n# 1. Install Czarina (one-time)\ngit clone https://github.com/apathy-ca/czarina.git ~/Source/GRID/claude-orchestrator\nln -s ~/Source/GRID/claude-orchestrator/czarina ~/.local/bin/czarina\nczarina patterns update\n\n# 2. One-command launch from your plan (v0.7.1+)\ncd ~/my-projects/awesome-app\nczarina analyze plan.md --go  # Analyzes, configures, launches - all automatic!\n\n# Alternative: Manual configuration (if you prefer)\nczarina init\nnano .czarina/config.json\nnano .czarina/workers/backend.md\nczarina launch\n```\n\n**See [QUICK_START.md](QUICK_START.md) for complete guide.**\n\n---\n\n## 🌟 Key Features\n\n- 🤖 **Agent-Agnostic** - Works with 9+ AI coding assistants (Claude Code, Aider, Cursor, Kilocode, Windsurf, Cline, Roo-Code, Continue, Copilot Edits)\n- ⚡ **95-98% Autonomy** - Daemon system with auto-approval reduces manual intervention to 2-5%\n- 🧠 **Persistent Memory** - Workers remember and learn from past sessions\n- 📚 **43K+ Agent Rules** - Production-tested best practices built-in\n- 🎯 **One-Command Launch** - `czarina analyze plan.md --go` - from plan to running in \u003c60 seconds\n- 🌳 **Git Worktrees** - Each worker gets isolated workspace for true parallelism\n- 🔀 **Auto Branches** - Worker branches created and managed automatically\n- 📊 **Battle-Tested** - SARK v2.0: 10 workers, 3-4x speedup\n\n**Latest Updates:** See [CHANGELOG.md](CHANGELOG.md) for version history and recent releases.\n\n---\n\n## 📊 Real-World Results\n\n### SARK v2.0 Project (Production Case Study)\n- **Team:** 10 AI workers (6 engineers, 2 QA, 2 docs)\n- **Timeline:** 6-8 weeks (vs. 22-26 weeks sequential)\n- **Speedup:** 3-4x faster delivery\n- **Autonomy:** 95-98% with daemon auto-approval\n- **Status:** ✅ Successfully deployed\n\nThis demonstrates Czarina can handle large-scale projects with 10+ workers in parallel.\n\n### ✨ Latest Release - v0.7.2 (December 2025)\n\n**Automated Multi-Phase Orchestration**\n- Automatic phase completion detection\n- Seamless phase transitions\n- Hands-free multi-phase projects\n\nSee [CHANGELOG.md](CHANGELOG.md) for complete release notes and migration guides.\n\n---\n## 🤖 Supported Agents\n\nCzarina orchestrates 9+ AI coding assistants with varying autonomy levels:\n\n| Agent | Autonomy | Best For |\n|-------|----------|----------|\n| **Aider** | 95-98% | Full automation, rapid iteration |\n| **Windsurf** | 85-95% | AI-native IDE, cascade workflows |\n| **Cursor** | 80-90% | VS Code users, UI/UX work |\n| **Continue.dev** | 75-85% | Local/free, customizable |\n| **Claude Code** | 70-80% | Architecture, complex reasoning |\n| **Kilocode** | 80-90% | Performance, large codebases |\n| **Cline** | 75-85% | Claude-powered VS Code |\n| **Roo-Code** | 70-80% | Terminal-native, CLI tools |\n| **GitHub Copilot** | 70-80% | GitHub integration, PR reviews |\n\n**Mix and match** agents within a single orchestration - assign each worker the best tool for their role.\n\n**See [AGENT_COMPATIBILITY.md](AGENT_COMPATIBILITY.md) for detailed comparison.**\n\n\n## 🛠️ CLI Reference\n\n```bash\n# Project Management\nczarina init                        # Initialize in current directory\nczarina init --with-memory          # Initialize with memory system\nczarina init --with-rules           # Initialize with agent rules\nczarina init --with-memory --with-rules  # Initialize with both\nczarina list                        # List all projects\nczarina launch                      # Launch workers\nczarina status                      # Show status\n\n# Memory System (v0.7.0+)\nczarina memory init                 # Initialize memory system\nczarina memory query \"\u003csearch\u003e\"     # Search past sessions\nczarina memory extract              # Extract session learnings\nczarina memory rebuild              # Rebuild search index\nczarina memory status               # Show memory status\n\n# Daemon (Auto-Approval)\nczarina daemon start                # Start auto-approval\nczarina daemon stop                 # Stop daemon\nczarina daemon logs                 # View logs\n\n# Pattern Library\nczarina patterns update             # Get latest patterns\nczarina patterns pending            # List discoveries to share\n```\n\n---\n\n## 📖 Documentation\n\n### Getting Started\n- **[QUICK_START.md](QUICK_START.md)** - 5-minute guide\n- **[MIGRATION_v0.7.0.md](MIGRATION_v0.7.0.md)** - **v0.6.2 → v0.7.0 migration guide**\n- **[docs/guides/CZAR_ROLE.md](docs/guides/CZAR_ROLE.md)** - **Czar coordination role** (critical!)\n- **[PRODUCTION_READINESS.md](PRODUCTION_READINESS.md)** - Production checklist\n- **[docs/guides/WORKER_SETUP_GUIDE.md](docs/guides/WORKER_SETUP_GUIDE.md)** - Worker configuration\n- **[AGENT_RULES.md](AGENT_RULES.md)** - 53+ rules \u0026 templates for quality code (NEW!)\n\n### v0.7.0 Features\n- **[MEMORY_GUIDE.md](MEMORY_GUIDE.md)** - **Memory system usage \u0026 best practices**\n- **[AGENT_RULES.md](AGENT_RULES.md)** - **Agent rules integration guide**\n- **[czarina_memory_spec.md](czarina_memory_spec.md)** - Memory architecture specification\n\n### Advanced\n- **[docs/PHASE_MANAGEMENT.md](docs/PHASE_MANAGEMENT.md)** - Phase lifecycle \u0026 smart cleanup\n- **[docs/BRANCH_NAMING.md](docs/BRANCH_NAMING.md)** - Branch naming conventions\n- **[czarina-core/docs/DAEMON_SYSTEM.md](czarina-core/docs/DAEMON_SYSTEM.md)** - Auto-approval system\n- **[czarina-core/patterns/](czarina-core/patterns/)** - Error recovery \u0026 best practices\n- **[docs/guides/SUPPORTED_AGENTS.md](docs/guides/SUPPORTED_AGENTS.md)** - Agent comparison\n- **[docs/](docs/)** - Full documentation hub\n\n---\n\n## 🤝 Contributing\n\n**Found a bug? Have an improvement?**\n\nUse the inbox system:\n```bash\ncp czarina-inbox/templates/FIX_DONE.md czarina-inbox/fixes/$(date +%Y-%m-%d)-my-fix.md\n```\n\n**Discovered a pattern?**\n\nShare it with the community:\n```bash\nczarina patterns pending      # Check what's ready\nczarina patterns contribute   # Submit upstream\n```\n\n**See [czarina-inbox/README.md](czarina-inbox/README.md) for details.**\n\n---\n\n## 💡 Use Cases\n\n**Ideal for:**\n- ✅ Large refactors across multiple files\n- ✅ Parallel feature development\n- ✅ Documentation generation\n- ✅ Test writing and coverage\n- ✅ Multi-language projects\n\n**Not ideal for:**\n- ❌ Small, focused tasks (\u003c 1 hour)\n- ❌ Highly coupled code requiring tight coordination\n- ❌ Tasks requiring human creativity/judgment\n\n---\n\n## 📂 Repository Structure\n\n```\nczarina-orchestrator/\n├── czarina                    # Main CLI executable\n├── .cursorrules               # Agent-agnostic development rules\n├── QUICK_START.md             # 5-minute getting started\n├── PRODUCTION_READINESS.md    # Production checklist\n├── AGENT_COMPATIBILITY.md     # Agent comparison matrix\n│\n├── czarina-core/              # Framework \u0026 CLI\n│   ├── daemon/                # Auto-approval system\n│   ├── patterns/              # Error recovery \u0026 best practices\n│   ├── templates/             # Analysis templates\n│   └── docs/                  # Framework documentation\n│\n├── czarina-inbox/             # Community improvements\n│   ├── fixes/                 # Bug fixes \u0026 improvements\n│   ├── patterns/              # Pattern discoveries\n│   └── templates/             # Submission templates\n│\n├── agents/                    # Agent profiles \u0026 launchers\n│   ├── profiles/              # JSON agent definitions\n│   └── guides/                # Agent-specific setup\n│\n└── docs/                      # Documentation\n    ├── guides/                # User guides\n    ├── analysis/              # Session reports\n    └── archive/               # Legacy docs\n```\n\n---\n\n## 🌟 Status\n\n**Production Ready** ✅\n- Multi-agent orchestration (9+ agents)\n- Autonomous daemon (95-98% autonomy)\n- Git workflow automation\n- Real-world tested (10 workers)\n- Pattern library (auto-updating)\n\n**Active Development** 🚧\n- Web dashboard\n- Enhanced monitoring\n- More agent profiles\n\n---\n\n## 📜 License\n\nMIT License - see [LICENSE](LICENSE)\n\n---\n\n*Built with ❤️ by humans and AI working together*\n\n**Ready to orchestrate?** → [Quick Start Guide](QUICK_START.md) 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapathy-ca%2Fczarina","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapathy-ca%2Fczarina","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapathy-ca%2Fczarina/lists"}