open-index/open-npm huggingface dataset:
npm package: @maestroai/cli
Description: CLI for Maestro - orchestrate multiple Claude Code agents working as a team
Latest version: 0.1.2

# @maestroai/cli

> Orchestrate multiple Claude Code agents working as a team

## Installation

```bash
# Install globally
npm install -g @maestroai/cli

# Or use npx (no installation needed)
npx @maestroai/cli init
```

## Prerequisites

- **Node.js** >= 20.0.0
- **Claude CLI** - Install from https://claude.ai/code

### Installing Claude CLI

```bash
# macOS / Linux
npm install -g @anthropic-ai/claude-code

# Or with Homebrew (macOS)
brew install anthropic/claude/claude-code
```

## Usage

### Initialize a new project

```bash
maestro init
```

This will:
- Check that Claude CLI is installed
- Create a `maestro.yaml` configuration file
- Create a `.maestro/` directory for messages and logs
- Create a `.agents/` directory with customizable agent prompts
- Generate a `todo.md` with planned tasks (optional)

### Start the orchestration

```bash
maestro start
```

Launches the TUI (Terminal User Interface) for monitoring agents.

### Check status

```bash
maestro status
```

Shows running agents and their states.

### Stop orchestration

```bash
maestro stop
```

Gracefully stops all running agents.

## Configuration

Edit `maestro.yaml` to customize:
- Number and types of agents
- Working directory
- Model selection
- Budget limits
- Feedback mode (supervised/autonomous)

## Agent Roles

Maestro includes specialized agent roles:
- **Orchestrator** - Coordinates the overall workflow
- **Project Manager** - Breaks down work and manages tasks
- **Architect** - Designs system architecture
- **Developer** - Writes implementation code
- **Designer** - Creates UI/UX designs
- **QA Engineer** - Tests and validates work
- **DevOps** - Handles deployment and infrastructure
- **Technical Writer** - Creates documentation
- **Code Reviewer** - Reviews and validates changes

## Process Safety

By default, agents follow process safety rules to keep your machine stable:

**Agents will:**
- Write production code, tests, configs, and docs
- Run lightweight commands (linters, type-checks on single files)
- Run targeted test files
- Install individual packages

**Agents will not:**
- Run builds (`npm run build`, `cargo build`, etc.)
- Run Docker commands
- Start dev servers
- Run full dependency installs
- Run full test suites

You can customize these rules by editing the `.agents/*.md` files.

## License

MIT
npm package: @maestroai/core
Description: Core orchestration logic for Maestro multi-agent system
Latest version: 0.1.2

# @maestroai/core

> Core orchestration logic for Maestro multi-agent system

This package contains the shared logic for coordinating multiple Claude Code agents working together on software projects.

## Features

- **Task Management** - Parse, write, and track tasks in markdown format
- **Agent Lifecycle** - Spawn, monitor, and coordinate agent processes
- **Messaging** - File-based message passing between agents
- **Configuration** - YAML-based project and agent configuration
- **Planning** - AI-powered task decomposition using Claude
- **File Watching** - Monitor files for changes and agent activity

## Usage

```typescript
import {
  Planner,
  TaskParser,
  TaskWriter,
  Orchestrator,
  Config,
} from '@maestroai/core';

// Parse tasks from markdown
const parser = new TaskParser();
const { tasks } = parser.parse(markdownContent);

// Plan tasks from a goal
const planner = new Planner({
  model: 'sonnet',
  workingDirectory: process.cwd(),
});
const plannedTasks = await planner.decompose('Build a REST API');

// Orchestrate agents
const config = Config.fromFile('maestro.yaml');
const orchestrator = new Orchestrator(config);
await orchestrator.start();
```

## License

MIT