Metadata-Version: 2.4
Name: maos-cli
Version: 0.3.0
Summary: Orchestrate swarms of Claude subagents with natural language
Project-URL: Homepage, https://github.com/vincentsider/maos-cli
Project-URL: Documentation, https://github.com/vincentsider/maos-cli#readme
Project-URL: Repository, https://github.com/vincentsider/maos-cli
Project-URL: Issues, https://github.com/vincentsider/maos-cli/issues
Project-URL: Source Code, https://github.com/vincentsider/maos-cli
Author-email: Vincent Sider <vincent@maos.dev>
Maintainer-email: Vincent Sider <vincent@maos.dev>
License: MIT
License-File: LICENSE
Keywords: agents,ai,automation,claude,llm,orchestration,sdk,swarm
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Distributed Computing
Requires-Python: >=3.11
Requires-Dist: aiofiles>=23.2.1
Requires-Dist: aiosqlite>=0.19.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: rich>=13.7.0
Requires-Dist: typer>=0.9.0
Provides-Extra: api
Requires-Dist: fastapi>=0.104.1; extra == 'api'
Requires-Dist: httpx>=0.25.2; extra == 'api'
Requires-Dist: pydantic>=2.5.0; extra == 'api'
Requires-Dist: uvicorn[standard]>=0.24.0; extra == 'api'
Provides-Extra: dev
Requires-Dist: black>=23.11.0; extra == 'dev'
Requires-Dist: mypy>=1.7.1; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.1; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest>=7.4.3; extra == 'dev'
Requires-Dist: ruff>=0.1.6; extra == 'dev'
Provides-Extra: full
Requires-Dist: aioredis>=2.0.1; extra == 'full'
Requires-Dist: cryptography>=41.0.7; extra == 'full'
Requires-Dist: fastapi>=0.104.1; extra == 'full'
Requires-Dist: httpx>=0.25.2; extra == 'full'
Requires-Dist: prometheus-client>=0.19.0; extra == 'full'
Requires-Dist: pydantic>=2.5.0; extra == 'full'
Requires-Dist: pyjwt>=2.8.0; extra == 'full'
Requires-Dist: redis>=5.0.1; extra == 'full'
Requires-Dist: sqlalchemy[asyncio]>=2.0.23; extra == 'full'
Requires-Dist: uvicorn[standard]>=0.24.0; extra == 'full'
Provides-Extra: redis
Requires-Dist: aioredis>=2.0.1; extra == 'redis'
Requires-Dist: redis>=5.0.1; extra == 'redis'
Description-Content-Type: text/markdown

# MAOS - Multi-Agent Orchestration System

**Create and orchestrate Claude subagent swarms with simple natural language commands**

## What MAOS Does

MAOS lets you spawn multiple Claude agents that work in parallel on your tasks. Instead of writing Python code, just type what you want in plain English:

- **"spawn 3 agents to review my code"** → Creates 3 specialized Claude agents
- **"implement the requirements in prd.md"** → Distributes work across multiple agents
- **"fix all the security issues"** → Agents work together to find and fix problems

## Installation (2 minutes)

### Step 1: Install MAOS

```bash
# Install with pipx (recommended)
pipx install maos-cli

# Or with pip
pip install maos-cli
```

### Step 2: Start Using

```bash
# Go to any project directory
cd your-project

# Start MAOS chat interface
maos chat
```

That's it! Now type commands in natural language.

## Quick Start Examples

### Basic Usage (No Claude CLI Required)

When you run `maos chat`, MAOS creates Claude subagent files that define specialized agents:

```
MAOS> spawn 3 agents to review my code
✓ Created Claude subagents: reviewer, security-auditor, tester
✓ Agent files created in .claude/agents/

MAOS> show status
📊 3 agents ready for use
  • reviewer.md - Code review specialist
  • security-auditor.md - Security vulnerability scanner  
  • tester.md - Test coverage analyzer
```

The agents are created as Markdown files in `.claude/agents/` directory. These work with Claude Code when it's installed.

### With Claude CLI Installed (Full Functionality)

If you have Claude Code CLI installed, MAOS can actually run the agents:

```bash
# First, install Claude Code CLI
npm install -g @anthropic-ai/claude-code

# Authenticate with your API key
export ANTHROPIC_API_KEY="your-api-key"
# Or use: claude login
```

Now MAOS will spawn actual Claude processes:

```
MAOS> spawn 5 agents to analyze my codebase
✓ Created Claude subagents: architect, developer, tester, reviewer, security-auditor
✓ Spawned 5 Claude CLI instances
✓ Agents working in parallel...

MAOS> implement the PRD in requirements.md
✓ Analyzing requirements...
✓ Distributed 12 tasks across agents
⚡ Agents working:
  • architect: Designing system structure...
  • developer: Implementing core features...
  • tester: Writing test specifications...
```

## What Gets Created

MAOS creates specialized Claude agents as Markdown files:

```
your-project/
├── .claude/
│   └── agents/
│       ├── reviewer.md        # Code review specialist
│       ├── developer.md       # Implementation expert
│       ├── tester.md          # Testing specialist
│       └── security-auditor.md # Security scanner
├── your_code.py
└── requirements.md
```

Each agent file looks like this:

```markdown
---
name: reviewer
description: Code review specialist for quality and security
tools: Read, Grep, Glob, Bash
---

You are a senior code reviewer ensuring high standards...
[detailed instructions for the agent]
```

## Natural Language Commands

Just type what you want:

### Creating Agents
- `spawn 3 agents to review my code`
- `create a swarm to implement the PRD`
- `start 5 agents for testing`

### Task Management
- `implement requirements.md`
- `fix all security issues`
- `review the codebase`
- `write tests for everything`

### Monitoring
- `show status`
- `list agents`
- `show progress`

### Utility
- `help` - Show commands
- `exit` - Leave MAOS

## Installation Troubleshooting

### If `pipx` is not installed:
```bash
python3 -m pip install --user pipx
pipx ensurepath
# Restart terminal, then:
pipx install maos-cli
```

### If `maos` command not found:
```bash
# Add pipx binaries to PATH
export PATH="$HOME/.local/bin:$PATH"
# Add to your ~/.bashrc or ~/.zshrc to make permanent
```

### For development/testing:
```bash
# Clone and install from source
git clone https://github.com/yourusername/maos.git
cd maos
pip install -e .
```

## How It Works

1. **You type a command** in natural language
2. **MAOS creates specialized agents** as `.claude/agents/*.md` files
3. **Each agent has expertise** (reviewer, tester, developer, etc.)
4. **With Claude CLI installed**, MAOS spawns actual Claude processes
5. **Agents work in parallel** on your tasks

## Requirements

- **Python 3.11+** - For running MAOS
- **Claude Code CLI** (optional) - For actually running agents
  ```bash
  npm install -g @anthropic-ai/claude-code
  ```

## Common Issues & Solutions

### "Claude CLI not found"
This is normal! MAOS still creates agent files that you can use manually. To enable full functionality:
```bash
npm install -g @anthropic-ai/claude-code
claude login  # or export ANTHROPIC_API_KEY="..."
```

### "No agents were created"
Check if the `.claude/agents/` directory exists:
```bash
ls -la .claude/agents/
```

### Clean up agents
```bash
rm -rf .claude/agents/*.md
```

## License

MIT - Use freely in your projects!

## Quick Links

- [PyPI Package](https://pypi.org/project/maos-cli/)
- [Report Issues](https://github.com/yourusername/maos/issues)
- [Documentation](https://github.com/yourusername/maos/wiki)