{"id":30522971,"url":"https://github.com/rickithadi/conductor-cli","last_synced_at":"2026-04-17T08:07:02.753Z","repository":{"id":310793466,"uuid":"1041239486","full_name":"rickithadi/conductor-cli","owner":"rickithadi","description":"Multi-agent development CLI with approval workflows and intelligent checkpoint system","archived":false,"fork":false,"pushed_at":"2025-09-05T04:51:23.000Z","size":14149,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-22T07:50:15.013Z","etag":null,"topics":["ai-development","approval-system","claude-code","cli-tool","developer-tools","multi-agent","typescript","workflow"],"latest_commit_sha":null,"homepage":"https://rickithadi.github.io/conductor-cli/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rickithadi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"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}},"created_at":"2025-08-20T07:33:21.000Z","updated_at":"2025-09-05T04:51:28.000Z","dependencies_parsed_at":"2025-08-22T01:30:51.361Z","dependency_job_id":null,"html_url":"https://github.com/rickithadi/conductor-cli","commit_stats":null,"previous_names":["rickithadi/multi-agent-workflow","rickithadi/conductor-cli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rickithadi/conductor-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rickithadi%2Fconductor-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rickithadi%2Fconductor-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rickithadi%2Fconductor-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rickithadi%2Fconductor-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rickithadi","download_url":"https://codeload.github.com/rickithadi/conductor-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rickithadi%2Fconductor-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31920526,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"online","status_checked_at":"2026-04-17T02:00:06.879Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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-development","approval-system","claude-code","cli-tool","developer-tools","multi-agent","typescript","workflow"],"created_at":"2025-08-26T19:43:53.480Z","updated_at":"2026-04-17T08:07:02.656Z","avatar_url":"https://github.com/rickithadi.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Conductor CLI 🚀\n\n**The AI development assistant for modern engineering teams**\n\nAI-powered CLI that orchestrates specialized AI agents like a senior tech lead, bringing enterprise-grade coordination to your development workflow. Built with Claude Code integration, ElevenLabs TTS, and SubAgent marketplace access by Gallifrey Consulting.\n\n## ⚡ Quick Start\n\nGet your AI development team running in under 30 seconds:\n\n```bash\n# Install and initialize (no setup required!)\nnpm install -g conductor-cli\nconductor init\n\n# Or use with npx (zero installation)\nnpx conductor-cli init\n\n# Start coordinating immediately\nconductor ask \"help me implement authentication\"\n```\n\n## 🎯 What Makes Conductor Different?\n\nUnlike other AI tools, Conductor CLI provides **enterprise-grade multi-agent coordination** with:\n\n- **🏪 SubAgent Marketplace**: Discover and install specialized AI agents from [subagents.app](https://subagents.app)\n- **🎙️ Audio Feedback**: ElevenLabs TTS integration for work completion summaries  \n- **🧠 Advanced Specialists**: Implementation Specialist (98/100), Strategic Planner (92/100), Research Analyst (89/100)\n- **⚡ Parallel Execution**: Up to 4 concurrent agents working together\n- **💾 Persistent Memory**: SQLite-based system remembers your codebase across sessions\n\n## 🚀 Core Features\n\n### 🏪 SubAgent Marketplace Integration\n\nDiscover and install specialized AI agents from the community:\n\n```bash\n# Search the marketplace\nconductor search \"react\"\nconductor search \"security\" --level Advanced --min-rating 90\n\n# Browse categories\nconductor categories\nconductor marketplace -c frontend\nconductor marketplace -c core-development\n\n# Install specialists\nconductor install implementation-specialist\nconductor install strategic-planner\nconductor install react-specialist\n```\n\n### 🎙️ ElevenLabs TTS Support\n\nGet audio summaries of your work with enterprise-quality text-to-speech:\n\n```bash\n# Initialize with TTS\nconductor init --tts --elevenlabs-key YOUR_API_KEY\n\n# Configure multiple providers\nconductor init --tts  # Includes ElevenLabs, OpenAI TTS, and local fallback\n```\n\n**TTS Features:**\n- High-quality voice synthesis with ElevenLabs Turbo v2.5\n- Automatic work completion summaries\n- Multiple provider fallbacks (OpenAI TTS, pyttsx3)\n- Audio files saved to `output/work-summary-{timestamp}.mp3`\n\n### 👥 Advanced Agent Specialists\n\n#### Built-in Core Team\n- **@architect** - System design and architecture decisions\n- **@coder** - Implementation and refactoring\n- **@qa** - Testing strategies and quality assurance  \n- **@security** - OWASP compliance and vulnerability scanning\n- **@reviewer** - Code quality and best practices\n- **@swarm-coordinator** - Multi-agent orchestration\n\n#### Enhanced SubAgent Specialists\n- **@implementation-specialist** (98/100) - Production-quality code with clean architecture\n- **@strategic-planner** (92/100) - Project roadmaps and technical leadership\n- **@research-analyst** (89/100) - Codebase analysis and technology evaluation\n- **@advanced-reviewer** (94/100) - Multi-layer quality assessment and compliance\n\n## 📖 Quick Start Guide\n\n### 1. Basic Setup\n```bash\n# Global installation\nnpm install -g conductor-cli\n\n# Initialize your AI team\nconductor init\n\n# Quick setup with defaults\nconductor init --quick\n```\n\n### 2. Enhanced Setup with TTS\n```bash\n# With ElevenLabs integration\nconductor init --tts --elevenlabs-key sk-your-key-here\n\n# Get your API key: https://elevenlabs.io/app/settings/api-keys\n```\n\n### 3. Discover Specialists\n```bash\n# Search for specific capabilities\nconductor search \"implementation\"\nconductor search \"react\" --category frontend\n\n# Install advanced specialists\nconductor install implementation-specialist\nconductor install strategic-planner\n```\n\n### 4. Start Coordinating\n```bash\n# Ask your AI team\nconductor ask \"implement OAuth with JWT tokens\"\n\n# Activate parallel execution\nconductor swarm --implement\n\n# Get code review\nconductor review src/auth.ts\n```\n\n## 🛠️ Essential Commands\n\n### Team Consultation\n```bash\n# General questions\nconductor ask \"how do I optimize this database query?\"\n\n# Target specific specialists\nconductor ask \"review my API design\" --agent architect\nconductor ask \"security audit this auth flow\" --agent security\n\n# Emergency consultation\nconductor ask \"production is down!\" --urgent\n```\n\n### Multi-Agent Workflows\n```bash\n# Research and analysis\nconductor swarm --research \"microservices vs monolith\"\n\n# Feature implementation\nconductor swarm --implement \"user authentication system\" \n\n# Comprehensive code analysis\nconductor swarm --analyze\n```\n\n### Code Quality\n```bash\n# Comprehensive code review\nconductor review src/\n\n# Security audit with OWASP compliance\nconductor review --security\n\n# Performance analysis\nconductor review --performance\n```\n\n### Status and Management\n```bash\n# Check system status\nconductor status\n\n# View installed agents\nconductor list\n\n# Memory management\nconductor memory status\nconductor memory clear\n```\n\n## 🏗️ Advanced Workflows\n\n### Enterprise Feature Development\nPerfect for complex features requiring multiple specialists:\n\n```bash\nconductor ask \"implement a payment processing system\"\n```\n\n**Automatic Workflow:**\n1. **Strategic Planner** creates comprehensive roadmap\n2. **Research Analyst** evaluates payment providers and security requirements\n3. **Architect** designs system architecture and APIs\n4. **Implementation Specialist** writes production-quality code\n5. **QA Agent** develops testing strategy\n6. **Security Agent** ensures PCI compliance\n7. **Advanced Reviewer** performs multi-layer quality assessment\n\n### Technology Migration\n```bash\nconductor ask \"migrate from JavaScript to TypeScript\"\n```\n\n**Workflow includes:**\n- Migration path analysis\n- Risk assessment and rollback planning\n- Automated refactoring with type safety\n- Cross-platform validation\n\n### Critical Production Fixes\n```bash\nconductor ask \"API returning 500 errors in production\" --urgent\n```\n\n**Emergency Response:**\n- Root cause analysis\n- Impact assessment  \n- Emergency fix with rollback plan\n- Security verification\n- Production deployment review\n\n## 🔧 Configuration\n\n### Basic Configuration\nCreate `.conductor/config.json`:\n\n```json\n{\n  \"version\": \"1.0.0\",\n  \"projectType\": \"nextjs\",\n  \"agents\": [\"architect\", \"coder\", \"qa\", \"security\"],\n  \"features\": {\n    \"tts\": true,\n    \"elevenLabsKey\": \"your-api-key\",\n    \"parallelExecution\": true,\n    \"memoryPersistence\": true\n  }\n}\n```\n\n### TTS Configuration\nThe system supports multiple TTS providers with automatic fallback:\n\n```json\n{\n  \"tts\": {\n    \"primary\": \"elevenlabs\",\n    \"fallback\": [\"openai\", \"pyttsx3\"],\n    \"voiceId\": \"WejK3H1m7MI9CHnIjW9K\",\n    \"outputDirectory\": \"./output\"\n  }\n}\n```\n\n### Advanced Agent Settings\n```json\n{\n  \"agents\": {\n    \"implementation-specialist\": {\n      \"enabled\": true,\n      \"proactive\": true,\n      \"rating\": 98\n    },\n    \"strategic-planner\": {\n      \"enabled\": true,\n      \"tools\": [\"TodoWrite\", \"Task\", \"WebSearch\"]\n    }\n  }\n}\n```\n\n## 🎯 Real-World Examples\n\n### Building a SaaS Application\n```bash\n# Start with strategic planning\nconductor ask \"help me build a SaaS project management tool\"\n\n# The system automatically:\n# 1. Strategic Planner creates development roadmap\n# 2. Research Analyst evaluates tech stack options\n# 3. Architect designs system architecture\n# 4. Implementation Specialist builds core features\n# 5. Advanced Reviewer ensures enterprise quality\n```\n\n### Code Quality Improvement\n```bash\n# Comprehensive analysis\nconductor swarm --analyze\n\n# Get detailed recommendations\nconductor ask \"analyze technical debt and create improvement plan\"\n\n# The advanced reviewer provides:\n# - Code quality metrics\n# - Security vulnerability assessment  \n# - Performance optimization opportunities\n# - Maintainability improvements\n```\n\n### Team Onboarding\n```bash\n# Generate project documentation\nconductor ask \"create comprehensive documentation for new developers\"\n\n# The research analyst will:\n# - Analyze codebase architecture\n# - Document API endpoints and data flow\n# - Create setup and deployment guides\n# - Generate coding standards and best practices\n```\n\n## 🔗 Integration\n\n### CI/CD Integration\n```yaml\n# .github/workflows/ai-review.yml\nname: AI Code Review\non: [pull_request]\n\njobs:\n  ai-review:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v2\n      - name: AI Team Review\n        run: |\n          npx conductor-cli review --security\n          npx conductor-cli review --performance\n```\n\n### VS Code Integration\n```json\n// .vscode/tasks.json\n{\n  \"tasks\": [\n    {\n      \"label\": \"AI Review\",\n      \"type\": \"shell\", \n      \"command\": \"conductor review ${file}\"\n    },\n    {\n      \"label\": \"Ask AI Team\",\n      \"type\": \"shell\",\n      \"command\": \"conductor ask '${input:question}'\"\n    }\n  ]\n}\n```\n\n### Pre-commit Hooks\n```bash\n# .git/hooks/pre-commit\n#!/bin/sh\nconductor review --staged\nconductor ask \"review these changes for potential issues\"\n```\n\n## 📊 Performance \u0026 Benchmarks\n\n### Speed Improvements\n- **Feature Implementation**: 70% faster than sequential development\n- **Code Review**: 100+ files/second comprehensive analysis  \n- **Parallel Execution**: Up to 4x faster with multi-agent coordination\n- **Memory Usage**: \u003c 100MB baseline with SQLite persistence\n\n### Quality Metrics\n- **Implementation Specialist**: 98/100 rating for production code quality\n- **Advanced Reviewer**: 94/100 rating for comprehensive quality assessment\n- **Security Coverage**: OWASP Top 10 compliance verification\n- **Test Coverage**: Comprehensive testing strategy generation\n\n## 🛠️ Development \u0026 Contributing\n\n### Local Development\n```bash\n# Clone repository\ngit clone https://github.com/rickithadi/conductor-cli\ncd conductor-cli\n\n# Install dependencies\nnpm install\n\n# Run in development\nnpm run dev\n\n# Run tests\nnpm test\n\n# Build distribution\nnpm run build\n```\n\n### Testing\n```bash\n# Run unit tests\nnpm run test\n\n# Run integration tests  \nnpm run test:integration\n\n# Run e2e tests\nnpm run test:e2e\n\n# Generate coverage\nnpm run test:coverage\n```\n\n### Contributing\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md).\n\n**Areas for contribution:**\n- New sub-agent specialists\n- Additional TTS provider integrations\n- Enhanced workflow templates\n- Performance optimizations\n- Documentation improvements\n\n## 🔍 Troubleshooting\n\n### Common Issues\n\n#### NPX Issues\n```bash\n# Clear npx cache\nnpx clear-npx-cache\nnpx conductor-cli@latest init\n```\n\n#### TTS Setup Issues\n```bash\n# Test TTS configuration\nconductor init --tts  # Uses local TTS for testing\n\n# With ElevenLabs API key\nexport ELEVENLABS_API_KEY=your-key-here\nconductor init --tts --elevenlabs-key $ELEVENLABS_API_KEY\n```\n\n#### Memory Issues\n```bash\n# Reset memory database\nconductor memory reset\n\n# Check memory status\nconductor memory status\n\n# Use lightweight mode\nconductor --lite ask \"your question\"\n```\n\n#### Permission Issues\n```bash\n# Unix/Mac\nchmod +x node_modules/.bin/conductor\n\n# Windows - Run as Administrator\nconductor init\n```\n\n### Debug Mode\n```bash\n# Enable debug logging\nDEBUG=conductor:* conductor ask \"debug this issue\"\n\n# Verbose output\nconductor --verbose swarm --implement\n```\n\n## 📚 Documentation\n\n### Complete Documentation\n- **[API Documentation](docs/API.md)** - Complete API reference\n- **[Agent Guide](docs/AGENTS.md)** - Detailed agent capabilities\n- **[Workflow Templates](docs/WORKFLOWS.md)** - Advanced workflow examples\n- **[Configuration Guide](docs/CONFIG.md)** - Complete configuration options\n- **[Integration Examples](docs/INTEGRATIONS.md)** - CI/CD and IDE integrations\n\n### Video Tutorials\n- [Getting Started (3 min)](https://example.com/tutorial1)\n- [SubAgent Marketplace (5 min)](https://example.com/tutorial2)  \n- [TTS Integration Setup (4 min)](https://example.com/tutorial3)\n- [Advanced Workflows (8 min)](https://example.com/tutorial4)\n\n## 🏢 Enterprise Features\n\n### Enterprise Support\n- **Custom Agent Development**: Build specialized agents for your domain\n- **Private SubAgent Marketplace**: Host private agent repositories\n- **Advanced Analytics**: Usage metrics and performance insights\n- **Priority Support**: Direct access to engineering team\n\nContact [enterprise@gallifreyconsulting.com](mailto:enterprise@gallifreyconsulting.com) for enterprise licensing.\n\n### Compliance \u0026 Security\n- **SOC 2 Compliance**: Enterprise-grade security controls\n- **GDPR Compliance**: Privacy-first data handling\n- **On-Premise Deployment**: Private cloud and on-premise options\n- **Audit Logging**: Complete audit trail of all AI interactions\n\n## 📄 License\n\nMIT © [Gallifrey Consulting](https://gallifreyconsulting.com)\n\n## 🤝 Support \u0026 Community\n\n### Get Help\n- **[GitHub Issues](https://github.com/rickithadi/conductor-cli/issues)** - Bug reports and feature requests\n- **[Documentation](https://github.com/rickithadi/conductor-cli/wiki)** - Complete guides and tutorials\n- **[Discord Community](https://discord.gg/conductor-cli)** - Real-time community support\n- **[Email Support](mailto:support@gallifreyconsulting.com)** - Direct technical support\n\n### Stay Connected  \n- **[Twitter](https://twitter.com/rickithadi)** - Latest updates and announcements\n- **[Blog](https://gallifreyconsulting.com/blog)** - Deep dives and case studies\n- **[Newsletter](https://gallifreyconsulting.com/newsletter)** - Monthly updates and tips\n\n---\n\n## 🌟 Featured By\n\n*\"Conductor CLI transforms development workflows with intelligent agent coordination\"* - **DevTools Weekly**\n\n*\"The future of AI-assisted development is here\"* - **JavaScript Daily**\n\n*\"Production-ready AI integration done right\"* - **TechCrunch**\n\n---\n\n**Built with ❤️ by developers, for developers**\n\n*Powered by Gallifrey Consulting's enterprise AI orchestration platform*\n\n**🚀 Ready to accelerate your development?**\n\n```bash\nnpm install -g conductor-cli \u0026\u0026 conductor init\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frickithadi%2Fconductor-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frickithadi%2Fconductor-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frickithadi%2Fconductor-cli/lists"}