🤖 d0 - Multi-Agent Automated Development AI

![Platform]()

d0 is a revolutionary development environment where multiple specialized AI agents collaborate to automate software development. Like a real company, each AI agent has distinct roles - President (Project Manager), Boss (Tech Lead), and Workers (Specialists) - working together through Node.js session management to deliver high-quality software projects.

🌟 What Makes This Special

Traditional Development:
``
Human → AI → Result
`

d0 Multi-Agent System:
`
Human → AI President → AI Tech Lead → Specialized AI Workers → Integration → Result
`

Key Benefits:
- 3x Faster Development with parallel processing
- Specialized Expertise in each domain (Frontend, Backend, DevOps, QA, etc.)
- Rich Collaboration between AI agents
- Higher Quality output with built-in review processes
- Scalable Team Size (1-10 agents based on project needs)

📌 Features

Explained in 3 lines:
1. Multiple AI agents (President, Manager, Workers) collaborate on development
2. Each operates in different terminal screens, exchanging messages
3. Role-based division of labor like human organizations for efficient development

Real Results:
- Survey system (EmotiFlow) completed in 3 hours
- Generated 12 innovative ideas
- Achieved 100% test coverage

🖥️ System Requirements

$3

- macOS (Intel & Apple Silicon)
- Linux (Ubuntu, Debian, CentOS, etc.)
- Windows (Windows 10/11)
- Architecture: x64, ARM64

$3

- Node.js v14.0.0 or higher
- Claude CLI (Anthropic's official CLI)

$3

No additional dependencies required! The system uses Node.js with proper readline interface management for session handling instead of tmux, making it fully compatible with Windows out of the box. The latest version includes enhanced terminal compatibility and conflict resolution with Claude CLI.

$3

- Frontend: React, Vue, Angular, Next.js, Svelte
- Backend: Node.js, Express, FastAPI, Django
- Databases: PostgreSQL, MongoDB, MySQL, Redis
- Cloud: AWS, GCP, Azure
- DevOps: Docker, Kubernetes, CI/CD

🚀 Installation

$3

`bash


Install globally

npm install -g @codemafia0000/d0

Verify installation

d0 --version
`

$3

`bash


macOS (using Homebrew)

brew install node

Ubuntu/Debian

sudo apt update
sudo apt install nodejs npm

CentOS/RHEL

sudo yum install nodejs npm

Windows (using Chocolatey)

choco install nodejs

Windows (using Scoop)

scoop install nodejs

Install Claude CLI (all platforms)

Visit: https://docs.anthropic.com/en/docs/claude-code

`

$3

`bash


Check all prerequisites


d0 status
`

📖 Usage

$3

`bash


Create project directory

mkdir my-ai-project && cd my-ai-project

Basic setup (3 workers)

d0 init

Custom team size (1-10 workers)

d0 init --workers 5

Force overwrite existing setup

d0 init --force --workers 8
`

$3

`bash


Launch all agent sessions

d0 start

View team configuration

d0 agents

Check system status

d0 status --detailed
`

$3

`bash


Quick connection to president

d0 hi president

Claude CLI starts automatically, or type:

claude
`

$3

Option 1: Connect and type directly
`bash
d0 hi president


Then type in president session:

"You are the president. Create a modern e-commerce platform..."

`

Option 2: Send message directly (easier!)
`bash
d0 tell "You are the president. Create a modern e-commerce platform with React frontend, Node.js backend, PostgreSQL database, and Docker deployment."
`

Option 3: Use a project brief file
`bash


Create project-brief.txt with detailed requirements


d0 tell --file project-brief.txt
`

What happens automatically:
1. President analyzes requirements and creates project strategy
2. Tech Lead (boss) breaks down tasks and assigns specialists
3. Frontend Developer (worker1) builds React components and UI
4. Backend Developer (worker2) creates APIs and database logic
5. DevOps Engineer (worker3) sets up deployment and infrastructure
6. QA Engineer (worker4) writes tests and ensures quality
7. Integration & Delivery - All components work together seamlessly

$3

`bash


Check real-time status

d0 status

View detailed team info

d0 agents

List all available sessions

d0 list

Connect to specific agents

d0 hi president # Project Manager
d0 hi boss # Tech Lead
d0 hi worker1 # Frontend Developer
d0 hi worker2 # Backend Developer
d0 hi worker3 # DevOps Engineer
`

$3

`bash


Stop all agent sessions and cleanup


d0 stop
`

🏢 Agent Configuration

$3

- Role: Decides overall direction
- Characteristic: Genius at understanding users' true needs
- Catchphrase: "Please realize this vision"

$3

- Role: Middle management coordinating the team
- Characteristic: Expert at drawing out members' creativity
- Catchphrase: "Please provide 3+ innovative ideas"

$3

- worker1: Design specialist (UI/UX)
- worker2: Data processing specialist
- worker3: Testing specialist

🛠 CLI Commands

$3

`bash


Setup & Initialization

d0 init [--workers 5] [--force] # Initialize and setup with custom worker count
d0 start # Start all agent sessions
d0 stop # Stop all sessions
d0 status # Check system status

Quick Connection

d0 hi president # Connect to Project Manager
d0 hi boss # Connect to Tech Lead
d0 hi worker1 # Connect to specific worker

Communication & Messaging

d0 tell "New project" # Send to president (default)
d0 tell boss "New project" # Send message to specific agent
d0 tell everyone "All hands meeting" # Send to all agents
d0 tell --file brief.txt # Send from file
d0 comm # Check communication status
d0 comm --clear # Clear message notifications

Team & Project Management

d0 agents # Show team overview
d0 list # List all available sessions
d0 team # Check team completion status
d0 team --reset # Reset team completion markers

Project Analysis

d0 analyze-project # Analyze current project structure
d0 auto-setup # Smart setup based on project analysis

History & Analytics

d0 history # Show development history
d0 analytics # Show project metrics

Help & Utilities

d0 --help # Show all commands
d0 completion bash # Generate shell completion
d0 monitor # Real-time monitoring
`

$3

`bash


🚀 Complete workflow in 3 commands (Works on Windows, macOS, Linux!)


d0 init --workers 5 # Initialize 5-agent team
d0 start # Start all agents
d0 tell "Create a modern React e-commerce app" # Start your project
`

$3

Enable tab completion for d0 commands to improve productivity:

`bash


For Bash users

d0 completion bash
source ~/.bashrc

For Zsh users

d0 completion zsh
source ~/.zshrc

For PowerShell users (Windows)

d0 completion powershell
. $PROFILE

For PowerShell Core users (Cross-platform)

d0 completion pwsh
. $PROFILE
`

After setup, you can use tab completion:
`bash
d0 # Shows: init, start, tell, hi, comm, team, etc.
d0 tell # Shows: president, boss, worker1, worker2, etc.
d0 hi # Shows: president, boss, worker1, worker2, etc.
`

$3

`bash


Analyze project structure and suggest agent roles

d0 analyze-project

Create instruction for new agent role

d0 generate-instruction [options]

Options:

-n, --name Display name

-e, --emoji Emoji

-d, --description Role description

Example: Create custom agent

d0 generate-instruction designer -n "UX Designer" -e "🎨" -d "User experience design specialist"
`

$3

`bash


Display project history

d0 history [options]

Options:

-t, --type History type: all|tasks|messages|progress|sessions

-a, --agent Filter by specific agent

-d, --days Past N days history (default: 7)

--export Export history to JSON file

Manually log message

d0 log-message

Manually log task

d0 log-task [--details

]

action: start|complete|block|progress

Project analysis and statistics

d0 analytics [--period ]

period: day|week|month

Example: Show only frontend agent task history

d0 history -t tasks -a frontend

Example: Export past 30 days history

d0 history -d 30 --export
`

$3

`bash


List all sessions with agent info

d0 list

Quick connect to agents (much easier than tmux!)

d0 hi president # Project Manager
d0 hi boss # Tech Lead
d0 hi worker1 # Frontend Developer
d0 hi worker2 # Backend Developer
d0 hi worker3 # DevOps Engineer

Check communication status

d0 comm # View message status
d0 comm --clear # Clear notifications

Team management

d0 team # Check team completion
d0 team --reset # Reset completion markers
`

💬 Inter-Agent Communication

$3

`bash

Simple message sending - these are equivalent:

d0 tell "Create a new project" # Defaults to president
d0 tell president "Create a new project" # Explicit president

Send to specific agents:

d0 tell boss "This is a new project"
d0 tell worker1 "Please create the UI"

Send message from file (for long instructions)

d0 tell --file project-brief.txt # To president (default)
d0 tell boss --file project-brief.txt # To specific agent

Broadcast to all agents

d0 tell everyone "Emergency: Please stop current work and prioritize security fix"
`

$3

President → Manager:
`
d0 tell boss "You are boss.

Project Name: Survey System Development

Vision:
A system that anyone can use easily and see results immediately

Success Criteria:
- Complete response in 3 clicks
- Real-time result display

Please realize this with innovative ideas."
`

📁 Project Structure

Project structure after setup:

`
your-project/
├── .d0/ # Agent environment directory
│ ├── config.json # Project configuration (version, workers, etc.)
│ ├── tmp/ # Session & communication files (gitignored)
│ │ ├── inbox/ # Agent message inboxes
│ │ ├── sessions.json # Active session tracking
│ │ └── message_status.json # Communication status
│ ├── history/ # Development history & logs (gitignored)
│ └── instructions/ # Agent behavioral guidelines
│ ├── president.md # Project manager instructions
│ ├── boss.md # Tech lead instructions
│ └── worker.md # Worker instructions
├── scripts/ # Utility scripts (team completion checker, etc.)
├── .gitignore # Auto-updated to exclude temporary files
└── CLAUDE.md # System configuration & agent setup
`

🎨 Example: EmotiFlow

$3

- 😊 Survey that can express emotions with emojis
- 📊 Real-time result viewing
- 📱 Mobile-friendly

$3

`bash
cd your-project

Check developed files

ls -la
`

🔧 Troubleshooting

$3

`bash

Check status

d0 status

Restart

d0 stop
d0 start
`

$3

`bash

Check logs

d0 history -t messages

Manual test

d0 tell boss "Test message"
`

$3

`bash

Full reset

d0 stop
rm -rf ./tmp/*
d0 init --force
`

🎓 Customization

$3

Use the CLI command to generate new agent instructions:
`bash


Generate custom agent role


d0 generate-instruction worker4 -n "Database Specialist" -e "🗄" -d "Database design and optimization expert"
`

$3

Edit files in the instructions/ directory to modify each agent's behavior, or use:
`bash


Regenerate instructions for existing roles


d0 generate-instruction boss -n "Tech Lead" -e "🎯"
`

📊 System Architecture

$3

`
┌─────────────────┐
│ PRESIDENT │ ← President screen (purple)
└─────────────────┘

┌────────┬────────┐
│ boss │worker1 │ ← Manager (red) and Worker1 (blue)
├────────┼────────┤
│worker2 │worker3 │ ← Worker2 and 3 (blue)
└────────┴────────┘
`

$3


`
President
↓ "Realize this vision"
Manager
↓ "Everyone, provide ideas"
Workers
↓ "Completed!"
Manager
↓ "All tasks completed"
President
`

💡 Why This is Amazing?

$3

`
Human → AI → Result
`

$3

`
Human → AI President → AI Manager → AI Workers×3 → Integration → Result
``

Benefits:
- 3x faster with parallel processing
- Leverage specialized expertise
- Rich in ideas
- Higher quality output

🤝 Contributing

Please submit bug reports and feature requests to Issues.

📄 License

MIT License

🙏 Acknowledgments

Inspired by Claude-Code-Communication by nishimoto265.