@olhapi/maestro-darwin-x64 0.1.0-rc.6 → 0.1.1
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 +29 -10
- package/lib/maestro +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,22 +4,36 @@ Maestro is a local-first orchestration runtime for agent-driven software work.
|
|
|
4
4
|
|
|
5
5
|
Website: [maestro.olhapi.com](https://maestro.olhapi.com/)
|
|
6
6
|
Repository: [github.com/olhapi/maestro](https://github.com/olhapi/maestro)
|
|
7
|
+
Docs: [maestro.olhapi.com/docs](https://maestro.olhapi.com/docs)
|
|
7
8
|
|
|
8
9
|
It combines a SQLite-backed tracker, an orchestrator that reads `WORKFLOW.md`, a private MCP daemon bridged by `maestro mcp`, and an HTTP server that serves the embedded dashboard plus JSON/WebSocket APIs.
|
|
9
10
|
|
|
10
|
-
Maestro stays local-first
|
|
11
|
+
Maestro stays local-first. External work is translated into Maestro projects and issues through the CLI, the embedded dashboard, or MCP prompts, then supervised through the same local queue, runtime state, MCP tools, and dashboard surfaces.
|
|
12
|
+
|
|
13
|
+
## Docs Website
|
|
14
|
+
|
|
15
|
+
The docs site is organized around the same operator flow the product uses:
|
|
16
|
+
|
|
17
|
+
- [Install](https://maestro.olhapi.com/docs/install)
|
|
18
|
+
- [Quickstart](https://maestro.olhapi.com/docs/quickstart)
|
|
19
|
+
- [Architecture](https://maestro.olhapi.com/docs/architecture)
|
|
20
|
+
- [Control center](https://maestro.olhapi.com/docs/control-center)
|
|
21
|
+
- [Workflow config](https://maestro.olhapi.com/docs/workflow-config)
|
|
22
|
+
- [Operations and observability](https://maestro.olhapi.com/docs/operations)
|
|
23
|
+
- [CLI reference](https://maestro.olhapi.com/docs/cli-reference)
|
|
24
|
+
- [Real Codex E2E harness](https://maestro.olhapi.com/docs/advanced/e2e-harness)
|
|
11
25
|
|
|
12
26
|
## Install
|
|
13
27
|
|
|
14
28
|
### npm
|
|
15
29
|
|
|
16
|
-
Current public
|
|
30
|
+
Current public npm install on supported platforms:
|
|
17
31
|
|
|
18
32
|
```bash
|
|
19
|
-
npm install -g @olhapi/maestro
|
|
33
|
+
npm install -g @olhapi/maestro
|
|
20
34
|
```
|
|
21
35
|
|
|
22
|
-
|
|
36
|
+
Install the newest prerelease instead:
|
|
23
37
|
|
|
24
38
|
```bash
|
|
25
39
|
npm install -g @olhapi/maestro@next
|
|
@@ -27,8 +41,6 @@ npm install -g @olhapi/maestro@next
|
|
|
27
41
|
|
|
28
42
|
The installed command name is still `maestro`.
|
|
29
43
|
|
|
30
|
-
Until the first stable release ships, the npm prerelease channel is published on `next`. After `v0.1.0`, `npm install -g @olhapi/maestro` will follow the stable `latest` channel.
|
|
31
|
-
|
|
32
44
|
Official npm builds currently cover:
|
|
33
45
|
|
|
34
46
|
| Platform | Arch | Notes |
|
|
@@ -94,7 +106,14 @@ maestro issue create "Fix auth bug" --project <project_id> --priority 1 --labels
|
|
|
94
106
|
maestro issue move ISS-1 ready
|
|
95
107
|
```
|
|
96
108
|
|
|
97
|
-
Projects
|
|
109
|
+
Projects use the local tracker only.
|
|
110
|
+
|
|
111
|
+
If you need to import work from another system, ask your MCP-capable agent to translate it into Maestro records. For example:
|
|
112
|
+
|
|
113
|
+
```text
|
|
114
|
+
Take my Jira issues from the "make a react todo app" epic and create the corresponding Maestro project, epics, and issues.
|
|
115
|
+
Use the current repo as the project repo path, keep the issues local, and mark the imported work ready.
|
|
116
|
+
```
|
|
98
117
|
|
|
99
118
|
Project descriptions are not just dashboard notes. Maestro passes `project.description` into every implementation, review, and done prompt by default, so use it for standing requirements, conventions, and validation expectations Codex should keep in mind for every issue.
|
|
100
119
|
|
|
@@ -172,7 +191,7 @@ maestro project stop <project_id> --api-url http://127.0.0.1:8787
|
|
|
172
191
|
|
|
173
192
|
`maestro run` is the long-lived process for a given database. It starts:
|
|
174
193
|
|
|
175
|
-
- the
|
|
194
|
+
- the local issue service and SQLite-backed store
|
|
176
195
|
- the orchestrator and agent runner
|
|
177
196
|
- a private MCP daemon used by `maestro mcp`
|
|
178
197
|
- the public HTTP server when `--port` is set or left at its default
|
|
@@ -212,7 +231,7 @@ maestro issue images list ISS-1
|
|
|
212
231
|
maestro issue images remove ISS-1 <image_id>
|
|
213
232
|
```
|
|
214
233
|
|
|
215
|
-
Image attachments are local-only
|
|
234
|
+
Image attachments are local-only for every issue. Maestro accepts PNG, JPEG, WEBP, and GIF files up to 10 MiB each and serves them back through the local HTTP API and dashboard.
|
|
216
235
|
|
|
217
236
|
Recurring automation:
|
|
218
237
|
|
|
@@ -280,7 +299,7 @@ Supported prompt-template variables are:
|
|
|
280
299
|
- `{{ attempt }}`
|
|
281
300
|
|
|
282
301
|
When a project has a description, Maestro's default implementation, review, and done prompts include it automatically under a `Project context:` section. Custom workflows can place `{{ project.description }}` wherever they want.
|
|
283
|
-
The default done prompt also tells the agent to create a short local preview video when the change can be demonstrated and attach it to an issue comment when the available
|
|
302
|
+
The default done prompt also tells the agent to create a short local preview video when the change can be demonstrated and attach it to an issue comment when the available local issue tooling supports that flow.
|
|
284
303
|
|
|
285
304
|
The checked-in [`WORKFLOW.md`](WORKFLOW.md) is this repository's own workflow example. It is not guaranteed to match fresh `workflow init` defaults exactly.
|
|
286
305
|
|
package/lib/maestro
CHANGED
|
Binary file
|