Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/rickithadi/conductor-cli

Multi-agent development CLI with approval workflows and intelligent checkpoint system
https://github.com/rickithadi/conductor-cli

ai-development approval-system claude-code cli-tool developer-tools multi-agent typescript workflow

Last synced: 2 months ago
JSON representation

Multi-agent development CLI with approval workflows and intelligent checkpoint system

Awesome Lists containing this project

README 

          
# Conductor CLI 🚀



**The AI development assistant for modern engineering teams**



AI-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.



## ⚡ Quick Start



Get your AI development team running in under 30 seconds:



```bash

# Install and initialize (no setup required!)

npm install -g conductor-cli

conductor init



# Or use with npx (zero installation)

npx conductor-cli init



# Start coordinating immediately

conductor ask "help me implement authentication"

```



## 🎯 What Makes Conductor Different?



Unlike other AI tools, Conductor CLI provides **enterprise-grade multi-agent coordination** with:



- **🏪 SubAgent Marketplace**: Discover and install specialized AI agents from [subagents.app](https://subagents.app)

- **🎙️ Audio Feedback**: ElevenLabs TTS integration for work completion summaries  

- **🧠 Advanced Specialists**: Implementation Specialist (98/100), Strategic Planner (92/100), Research Analyst (89/100)

- **⚡ Parallel Execution**: Up to 4 concurrent agents working together

- **💾 Persistent Memory**: SQLite-based system remembers your codebase across sessions



## 🚀 Core Features



### 🏪 SubAgent Marketplace Integration



Discover and install specialized AI agents from the community:



```bash

# Search the marketplace

conductor search "react"

conductor search "security" --level Advanced --min-rating 90



# Browse categories

conductor categories

conductor marketplace -c frontend

conductor marketplace -c core-development



# Install specialists

conductor install implementation-specialist

conductor install strategic-planner

conductor install react-specialist

```



### 🎙️ ElevenLabs TTS Support



Get audio summaries of your work with enterprise-quality text-to-speech:



```bash

# Initialize with TTS

conductor init --tts --elevenlabs-key YOUR_API_KEY



# Configure multiple providers

conductor init --tts  # Includes ElevenLabs, OpenAI TTS, and local fallback

```



**TTS Features:**

- High-quality voice synthesis with ElevenLabs Turbo v2.5

- Automatic work completion summaries

- Multiple provider fallbacks (OpenAI TTS, pyttsx3)

- Audio files saved to `output/work-summary-{timestamp}.mp3`



### 👥 Advanced Agent Specialists



#### Built-in Core Team

- **@architect** - System design and architecture decisions

- **@coder** - Implementation and refactoring

- **@qa** - Testing strategies and quality assurance  

- **@security** - OWASP compliance and vulnerability scanning

- **@reviewer** - Code quality and best practices

- **@swarm-coordinator** - Multi-agent orchestration



#### Enhanced SubAgent Specialists

- **@implementation-specialist** (98/100) - Production-quality code with clean architecture

- **@strategic-planner** (92/100) - Project roadmaps and technical leadership

- **@research-analyst** (89/100) - Codebase analysis and technology evaluation

- **@advanced-reviewer** (94/100) - Multi-layer quality assessment and compliance



## 📖 Quick Start Guide



### 1. Basic Setup

```bash

# Global installation

npm install -g conductor-cli



# Initialize your AI team

conductor init



# Quick setup with defaults

conductor init --quick

```



### 2. Enhanced Setup with TTS

```bash

# With ElevenLabs integration

conductor init --tts --elevenlabs-key sk-your-key-here



# Get your API key: https://elevenlabs.io/app/settings/api-keys

```



### 3. Discover Specialists

```bash

# Search for specific capabilities

conductor search "implementation"

conductor search "react" --category frontend



# Install advanced specialists

conductor install implementation-specialist

conductor install strategic-planner

```



### 4. Start Coordinating

```bash

# Ask your AI team

conductor ask "implement OAuth with JWT tokens"



# Activate parallel execution

conductor swarm --implement



# Get code review

conductor review src/auth.ts

```



## 🛠️ Essential Commands



### Team Consultation

```bash

# General questions

conductor ask "how do I optimize this database query?"



# Target specific specialists

conductor ask "review my API design" --agent architect

conductor ask "security audit this auth flow" --agent security



# Emergency consultation

conductor ask "production is down!" --urgent

```



### Multi-Agent Workflows

```bash

# Research and analysis

conductor swarm --research "microservices vs monolith"



# Feature implementation

conductor swarm --implement "user authentication system" 



# Comprehensive code analysis

conductor swarm --analyze

```



### Code Quality

```bash

# Comprehensive code review

conductor review src/



# Security audit with OWASP compliance

conductor review --security



# Performance analysis

conductor review --performance

```



### Status and Management

```bash

# Check system status

conductor status



# View installed agents

conductor list



# Memory management

conductor memory status

conductor memory clear

```



## 🏗️ Advanced Workflows



### Enterprise Feature Development

Perfect for complex features requiring multiple specialists:



```bash

conductor ask "implement a payment processing system"

```



**Automatic Workflow:**

1. **Strategic Planner** creates comprehensive roadmap

2. **Research Analyst** evaluates payment providers and security requirements

3. **Architect** designs system architecture and APIs

4. **Implementation Specialist** writes production-quality code

5. **QA Agent** develops testing strategy

6. **Security Agent** ensures PCI compliance

7. **Advanced Reviewer** performs multi-layer quality assessment



### Technology Migration

```bash

conductor ask "migrate from JavaScript to TypeScript"

```



**Workflow includes:**

- Migration path analysis

- Risk assessment and rollback planning

- Automated refactoring with type safety

- Cross-platform validation



### Critical Production Fixes

```bash

conductor ask "API returning 500 errors in production" --urgent

```



**Emergency Response:**

- Root cause analysis

- Impact assessment  

- Emergency fix with rollback plan

- Security verification

- Production deployment review



## 🔧 Configuration



### Basic Configuration

Create `.conductor/config.json`:



```json

{

  "version": "1.0.0",

  "projectType": "nextjs",

  "agents": ["architect", "coder", "qa", "security"],

  "features": {

    "tts": true,

    "elevenLabsKey": "your-api-key",

    "parallelExecution": true,

    "memoryPersistence": true

  }

}

```



### TTS Configuration

The system supports multiple TTS providers with automatic fallback:



```json

{

  "tts": {

    "primary": "elevenlabs",

    "fallback": ["openai", "pyttsx3"],

    "voiceId": "WejK3H1m7MI9CHnIjW9K",

    "outputDirectory": "./output"

  }

}

```



### Advanced Agent Settings

```json

{

  "agents": {

    "implementation-specialist": {

      "enabled": true,

      "proactive": true,

      "rating": 98

    },

    "strategic-planner": {

      "enabled": true,

      "tools": ["TodoWrite", "Task", "WebSearch"]

    }

  }

}

```



## 🎯 Real-World Examples



### Building a SaaS Application

```bash

# Start with strategic planning

conductor ask "help me build a SaaS project management tool"



# The system automatically:

# 1. Strategic Planner creates development roadmap

# 2. Research Analyst evaluates tech stack options

# 3. Architect designs system architecture

# 4. Implementation Specialist builds core features

# 5. Advanced Reviewer ensures enterprise quality

```



### Code Quality Improvement

```bash

# Comprehensive analysis

conductor swarm --analyze



# Get detailed recommendations

conductor ask "analyze technical debt and create improvement plan"



# The advanced reviewer provides:

# - Code quality metrics

# - Security vulnerability assessment  

# - Performance optimization opportunities

# - Maintainability improvements

```



### Team Onboarding

```bash

# Generate project documentation

conductor ask "create comprehensive documentation for new developers"



# The research analyst will:

# - Analyze codebase architecture

# - Document API endpoints and data flow

# - Create setup and deployment guides

# - Generate coding standards and best practices

```



## 🔗 Integration



### CI/CD Integration

```yaml

# .github/workflows/ai-review.yml

name: AI Code Review

on: [pull_request]



jobs:

  ai-review:

    runs-on: ubuntu-latest

    steps:

      - uses: actions/checkout@v2

      - name: AI Team Review

        run: |

          npx conductor-cli review --security

          npx conductor-cli review --performance

```



### VS Code Integration

```json

// .vscode/tasks.json

{

  "tasks": [

    {

      "label": "AI Review",

      "type": "shell", 

      "command": "conductor review ${file}"

    },

    {

      "label": "Ask AI Team",

      "type": "shell",

      "command": "conductor ask '${input:question}'"

    }

  ]

}

```



### Pre-commit Hooks

```bash

# .git/hooks/pre-commit

#!/bin/sh

conductor review --staged

conductor ask "review these changes for potential issues"

```



## 📊 Performance & Benchmarks



### Speed Improvements

- **Feature Implementation**: 70% faster than sequential development

- **Code Review**: 100+ files/second comprehensive analysis  

- **Parallel Execution**: Up to 4x faster with multi-agent coordination

- **Memory Usage**: < 100MB baseline with SQLite persistence



### Quality Metrics

- **Implementation Specialist**: 98/100 rating for production code quality

- **Advanced Reviewer**: 94/100 rating for comprehensive quality assessment

- **Security Coverage**: OWASP Top 10 compliance verification

- **Test Coverage**: Comprehensive testing strategy generation



## 🛠️ Development & Contributing



### Local Development

```bash

# Clone repository

git clone https://github.com/rickithadi/conductor-cli

cd conductor-cli



# Install dependencies

npm install



# Run in development

npm run dev



# Run tests

npm test



# Build distribution

npm run build

```



### Testing

```bash

# Run unit tests

npm run test



# Run integration tests  

npm run test:integration



# Run e2e tests

npm run test:e2e



# Generate coverage

npm run test:coverage

```



### Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md).



**Areas for contribution:**

- New sub-agent specialists

- Additional TTS provider integrations

- Enhanced workflow templates

- Performance optimizations

- Documentation improvements



## 🔍 Troubleshooting



### Common Issues



#### NPX Issues

```bash

# Clear npx cache

npx clear-npx-cache

npx conductor-cli@latest init

```



#### TTS Setup Issues

```bash

# Test TTS configuration

conductor init --tts  # Uses local TTS for testing



# With ElevenLabs API key

export ELEVENLABS_API_KEY=your-key-here

conductor init --tts --elevenlabs-key $ELEVENLABS_API_KEY

```



#### Memory Issues

```bash

# Reset memory database

conductor memory reset



# Check memory status

conductor memory status



# Use lightweight mode

conductor --lite ask "your question"

```



#### Permission Issues

```bash

# Unix/Mac

chmod +x node_modules/.bin/conductor



# Windows - Run as Administrator

conductor init

```



### Debug Mode

```bash

# Enable debug logging

DEBUG=conductor:* conductor ask "debug this issue"



# Verbose output

conductor --verbose swarm --implement

```



## 📚 Documentation



### Complete Documentation

- **[API Documentation](docs/API.md)** - Complete API reference

- **[Agent Guide](docs/AGENTS.md)** - Detailed agent capabilities

- **[Workflow Templates](docs/WORKFLOWS.md)** - Advanced workflow examples

- **[Configuration Guide](docs/CONFIG.md)** - Complete configuration options

- **[Integration Examples](docs/INTEGRATIONS.md)** - CI/CD and IDE integrations



### Video Tutorials

- [Getting Started (3 min)](https://example.com/tutorial1)

- [SubAgent Marketplace (5 min)](https://example.com/tutorial2)  

- [TTS Integration Setup (4 min)](https://example.com/tutorial3)

- [Advanced Workflows (8 min)](https://example.com/tutorial4)



## 🏢 Enterprise Features



### Enterprise Support

- **Custom Agent Development**: Build specialized agents for your domain

- **Private SubAgent Marketplace**: Host private agent repositories

- **Advanced Analytics**: Usage metrics and performance insights

- **Priority Support**: Direct access to engineering team



Contact [enterprise@gallifreyconsulting.com](mailto:enterprise@gallifreyconsulting.com) for enterprise licensing.



### Compliance & Security

- **SOC 2 Compliance**: Enterprise-grade security controls

- **GDPR Compliance**: Privacy-first data handling

- **On-Premise Deployment**: Private cloud and on-premise options

- **Audit Logging**: Complete audit trail of all AI interactions



## 📄 License



MIT © [Gallifrey Consulting](https://gallifreyconsulting.com)



## 🤝 Support & Community



### Get Help

- **[GitHub Issues](https://github.com/rickithadi/conductor-cli/issues)** - Bug reports and feature requests

- **[Documentation](https://github.com/rickithadi/conductor-cli/wiki)** - Complete guides and tutorials

- **[Discord Community](https://discord.gg/conductor-cli)** - Real-time community support

- **[Email Support](mailto:support@gallifreyconsulting.com)** - Direct technical support



### Stay Connected  

- **[Twitter](https://twitter.com/rickithadi)** - Latest updates and announcements

- **[Blog](https://gallifreyconsulting.com/blog)** - Deep dives and case studies

- **[Newsletter](https://gallifreyconsulting.com/newsletter)** - Monthly updates and tips



---



## 🌟 Featured By



*"Conductor CLI transforms development workflows with intelligent agent coordination"* - **DevTools Weekly**



*"The future of AI-assisted development is here"* - **JavaScript Daily**



*"Production-ready AI integration done right"* - **TechCrunch**



---



**Built with ❤️ by developers, for developers**



*Powered by Gallifrey Consulting's enterprise AI orchestration platform*



**🚀 Ready to accelerate your development?**



```bash

npm install -g conductor-cli && conductor init

```