orchestrai 0.1.12 → 0.1.13

package/README.md

@@ -1,20 +1,44 @@
 # orchestrai
 
-Run OrchestrAI — a local, terminal-oriented multi-agent DevOps orchestration prototype — with nothing pre-installed:
+Run OrchestrAI — a local, terminal-oriented multi-agent DevOps orchestration prototype — with nothing pre-installed. No Bun, no clone, no separate download step: the right platform binary installs automatically as part of this package (an optional dependency scoped to your OS/architecture).
+
+## Install
 
 ```
-npx orchestrai --project /path/to/your/project
+npm install -g orchestrai@latest
 ```
 
-or, with Bun:
+(pin a specific version instead of `@latest` any time you want a reproducible install — see [Reproducibility](#reproducibility) below.)
+
+## Set up your project, once
+
+```
+orchestrai init
+```
+
+Walks you through the target project path, which of the 5 agents to run, and whether to enable the optional LLM planning harness (provider/model/API key). Answer once — it's saved per project, in a `.orchestrai/` folder next to where you run it.
+
+## Run it
+
+```
+orchestrai
+```
+
+Starts the full local stack — 5 specialist agents (planning, DevOps, testing, documentation, security), an MCP tool server, and an orchestrator that routes work between them — then opens a **dashboard at [http://localhost:3000/dashboard](http://localhost:3000/dashboard)**. That's where you submit tasks and watch them run. In a real terminal it also opens an interactive terminal viewer alongside the dashboard.
+
+## Prefer a one-shot run instead?
 
 ```
-bunx orchestrai --project /path/to/your/project
+npx orchestrai@latest --project /path/to/your/project
 ```
 
-No Bun, no clone, no separate download step — the right platform binary installs automatically as part of this package (an optional dependency scoped to your OS/architecture), and this command just runs it.
+or, with Bun:
+
+```
+bunx orchestrai@latest --project /path/to/your/project
+```
 
-`orchestrai` starts the full local stack — 5 specialist agents (planning, DevOps, testing, documentation, security), an MCP tool server, and an orchestrator that routes work between them — then opens a **dashboard at [http://localhost:3000/dashboard](http://localhost:3000/dashboard)**. That's where you submit tasks and watch them run.
+Skips the global install and the saved per-project setup — useful for a quick one-off run, but `init` is the better path if you'll run it against the same project more than once.
 
 ## Supported platforms
 
@@ -36,22 +60,32 @@ xattr -d com.apple.quarantine "$(which orchestrai)"
 
 (or the equivalent path npm installed it under) before running it again.
 
-## Usage
+## All flags
 
 ```
 orchestrai                          # start everything, interactively in a real terminal
 orchestrai init                     # interactive setup wizard, run once per project
-orchestrai --project "/path/to/app"
+orchestrai --project "/path/to/app" # override the saved/inferred target path for this run
 orchestrai --only devops-agent      # start a subset of services (comma-separated)
 orchestrai --headless               # backend only, plain logs — no interactive viewer
 orchestrai --help
 ```
 
-`orchestrai init` walks you through target path, which services to run, and whether to enable the optional LLM planning harness (provider/model/API key) — answer once, and a plain `orchestrai` afterward reuses that setup with no flags needed.
-
 ## Reproducibility
 
-Each published version of this package corresponds to a specific, immutable build — pinning a version (`npx orchestrai@1.2.3`) always resolves the identical binary, not a rolling "latest."
+Each published version of this package corresponds to a specific, immutable build. Pin a version instead of `@latest` any time you want that guarantee:
+
+```
+npm install -g orchestrai@0.1.12
+```
+
+or for the one-shot form:
+
+```
+npx orchestrai@0.1.12 --project /path/to/your/project
+```
+
+Either always resolves the identical binary, not a rolling "latest."
 
 ## Source
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orchestrai",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "OrchestrAI — run the standalone orchestrai binary via bunx/npx with nothing pre-installed. The right platform binary is installed automatically as an optional dependency; no network download at runtime.",
   "license": "MIT",
   "bin": {