@maestroai/cli 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +112 -0
- package/dist/bin/maestro.d.ts +1 -0
- package/dist/bin/maestro.js +9 -0
- package/dist/bin/maestro.js.map +1 -0
- package/dist/chunk-5ZDNPLKN.js +1172 -0
- package/dist/chunk-5ZDNPLKN.js.map +1 -0
- package/dist/src/index.d.ts +5 -0
- package/dist/src/index.js +7 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/tui/App.d.ts +5 -0
- package/dist/src/tui/App.js +2393 -0
- package/dist/src/tui/App.js.map +1 -0
- package/package.json +51 -0
package/README.md
ADDED
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
# @maestroai/cli
|
|
2
|
+
|
|
3
|
+
> Orchestrate multiple Claude Code agents working as a team
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
# Install globally
|
|
9
|
+
npm install -g @maestroai/cli
|
|
10
|
+
|
|
11
|
+
# Or use npx (no installation needed)
|
|
12
|
+
npx @maestroai/cli init
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Prerequisites
|
|
16
|
+
|
|
17
|
+
- **Node.js** >= 20.0.0
|
|
18
|
+
- **Claude CLI** - Install from https://claude.ai/code
|
|
19
|
+
|
|
20
|
+
### Installing Claude CLI
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
# macOS / Linux
|
|
24
|
+
npm install -g @anthropic-ai/claude-code
|
|
25
|
+
|
|
26
|
+
# Or with Homebrew (macOS)
|
|
27
|
+
brew install anthropic/claude/claude-code
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Usage
|
|
31
|
+
|
|
32
|
+
### Initialize a new project
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
maestro init
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
This will:
|
|
39
|
+
- Check that Claude CLI is installed
|
|
40
|
+
- Create a `maestro.yaml` configuration file
|
|
41
|
+
- Create a `.maestro/` directory for messages and logs
|
|
42
|
+
- Create a `.agents/` directory with customizable agent prompts
|
|
43
|
+
- Generate a `todo.md` with planned tasks (optional)
|
|
44
|
+
|
|
45
|
+
### Start the orchestration
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
maestro start
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Launches the TUI (Terminal User Interface) for monitoring agents.
|
|
52
|
+
|
|
53
|
+
### Check status
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
maestro status
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Shows running agents and their states.
|
|
60
|
+
|
|
61
|
+
### Stop orchestration
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
maestro stop
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
Gracefully stops all running agents.
|
|
68
|
+
|
|
69
|
+
## Configuration
|
|
70
|
+
|
|
71
|
+
Edit `maestro.yaml` to customize:
|
|
72
|
+
- Number and types of agents
|
|
73
|
+
- Working directory
|
|
74
|
+
- Model selection
|
|
75
|
+
- Budget limits
|
|
76
|
+
- Feedback mode (supervised/autonomous)
|
|
77
|
+
|
|
78
|
+
## Agent Roles
|
|
79
|
+
|
|
80
|
+
Maestro includes specialized agent roles:
|
|
81
|
+
- **Orchestrator** - Coordinates the overall workflow
|
|
82
|
+
- **Project Manager** - Breaks down work and manages tasks
|
|
83
|
+
- **Architect** - Designs system architecture
|
|
84
|
+
- **Developer** - Writes implementation code
|
|
85
|
+
- **Designer** - Creates UI/UX designs
|
|
86
|
+
- **QA Engineer** - Tests and validates work
|
|
87
|
+
- **DevOps** - Handles deployment and infrastructure
|
|
88
|
+
- **Technical Writer** - Creates documentation
|
|
89
|
+
- **Code Reviewer** - Reviews and validates changes
|
|
90
|
+
|
|
91
|
+
## Process Safety
|
|
92
|
+
|
|
93
|
+
By default, agents follow process safety rules to keep your machine stable:
|
|
94
|
+
|
|
95
|
+
**Agents will:**
|
|
96
|
+
- Write production code, tests, configs, and docs
|
|
97
|
+
- Run lightweight commands (linters, type-checks on single files)
|
|
98
|
+
- Run targeted test files
|
|
99
|
+
- Install individual packages
|
|
100
|
+
|
|
101
|
+
**Agents will not:**
|
|
102
|
+
- Run builds (`npm run build`, `cargo build`, etc.)
|
|
103
|
+
- Run Docker commands
|
|
104
|
+
- Start dev servers
|
|
105
|
+
- Run full dependency installs
|
|
106
|
+
- Run full test suites
|
|
107
|
+
|
|
108
|
+
You can customize these rules by editing the `.agents/*.md` files.
|
|
109
|
+
|
|
110
|
+
## License
|
|
111
|
+
|
|
112
|
+
MIT
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../bin/maestro.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { createProgram } from '../src/index.js';\n\nconst program = createProgram();\nprogram.parse();\n"],"mappings":";;;;;;AAGA,IAAM,UAAU,cAAc;AAC9B,QAAQ,MAAM;","names":[]}
|