@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 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,9 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ createProgram
4
+ } from "../chunk-5ZDNPLKN.js";
5
+
6
+ // bin/maestro.ts
7
+ var program = createProgram();
8
+ program.parse();
9
+ //# sourceMappingURL=maestro.js.map
@@ -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":[]}