@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.
Files changed (3) hide show
  1. package/README.md +29 -10
  2. package/lib/maestro +0 -0
  3. 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 even when a project syncs issues from Linear. Provider-backed issues are synchronized into the local store, then supervised through the same local queue, runtime state, MCP tools, and dashboard surfaces as local kanban issues.
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 prerelease install on supported platforms:
30
+ Current public npm install on supported platforms:
17
31
 
18
32
  ```bash
19
- npm install -g @olhapi/maestro@next
33
+ npm install -g @olhapi/maestro
20
34
  ```
21
35
 
22
- Refresh an existing prerelease install:
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 default to the local `kanban` provider. You can also register a project with limited Linear-backed sync by passing `--provider linear --provider-project-ref <slug>` and, if needed, `--provider-endpoint` or `--provider-assignee`.
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 provider service and local SQLite-backed store
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, including for Linear-backed issues. Maestro accepts PNG, JPEG, WEBP, and GIF files up to 10 MiB each and serves them back through the local HTTP API and dashboard.
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 tracker or provider tooling supports that flow.
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
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@olhapi/maestro-darwin-x64",
3
- "version": "0.1.0-rc.6",
3
+ "version": "0.1.1",
4
4
  "description": "Maestro CLI binary for macOS x64",
5
5
  "license": "MIT",
6
6
  "files": [