@mutagent/cli 0.1.345 → 0.1.347

package/README.md

@@ -24,7 +24,7 @@
 </p>
 
 <p align="center">
-  <strong>Authenticate. Configure providers. Install MutagenT lifecycle tools.</strong>
+  <strong>Authenticate. Configure providers. Install Helix.</strong>
 </p>
 
 ---
@@ -33,8 +33,8 @@
 
 MutagenT CLI is the command-line client for the **MutagenT AI platform**. It is the
 entry point that AI coding agents and developers use to authenticate, set up a
-project, manage BYOK LLM providers, check account usage, and install MutagenT's
-lifecycle tooling (diagnostics, evaluator, and — when available — helix).
+project, manage BYOK LLM providers, check account usage, and install the
+standalone Helix binary.
 
 Every command is **AI-first**: run any command with `--json` for machine-readable
 output, and install the bundled Claude Code skill so coding agents know how to
@@ -45,7 +45,7 @@ drive the CLI without human hand-holding.
 - **AI-First Design**: Every command supports `--json` with `_directive` + `_links` for programmatic use by coding agents
 - **One-Command Auth**: `mutagent login` handles signup, onboarding, and CLI authorization via browser OAuth (or an API key for CI)
 - **BYOK Providers**: Configure and test your own LLM provider keys (`mutagent providers`)
-- **Lifecycle Meta-Installer**: `mutagent install <diagnostics|evaluator|helix>` pulls MutagenT packages (login-gated)
+- **Helix Installer**: `mutagent install helix` installs the standalone Helix binary into `~/.mutagent/bin` (no login needed)
 - **Claude Code Integration**: Install the CLI skill (`mutagent skills install`) and session-telemetry hooks (`mutagent hooks install`)
 - **Built-in Feedback**: `mutagent feedback send` reports bugs and product feedback, optionally with your coding-agent session transcript
 - **Bun-Native**: Built for speed with the Bun runtime (Node.js 22+ compatible)
@@ -98,8 +98,8 @@ flowchart TD
             HOOKS["mutagent hooks install"]
         end
 
-        subgraph LIFECYCLE ["Lifecycle Tools & Feedback"]
-            INSTALL_PKG["mutagent install <diagnostics|evaluator|helix>"]
+        subgraph LIFECYCLE ["Helix & Feedback"]
+            INSTALL_PKG["mutagent install helix"]
             FEEDBACK["mutagent feedback send"]
         end
     end
@@ -178,13 +178,11 @@ mutagent providers add                  # Add a provider key (interactive)
 mutagent providers test <provider-id>   # Verify connectivity
 ```
 
-### 4. Install Lifecycle Tools
+### 4. Install Helix
 
 ```bash
-mutagent install diagnostics            # Install diagnostics from npm (login-gated)
-mutagent install evaluator              # Install evaluator from npm
-mutagent install evaluator --version 1.2.3   # Pin a version
-mutagent install --help                 # helix (pending) | diagnostics | evaluator
+mutagent install helix                       # The standalone Helix binary → ~/.mutagent/bin/helix
+mutagent install helix --channel candidate   # The candidate build
 ```
 
 ### 5. Wire Up Your Coding Agent
@@ -324,23 +322,33 @@ mutagent agent list
   it in the cloud. The receipt is one JSON line on stderr; its reference is what
   `mutagent helix session` commands take.
 - `agent run` runs a local `agent.md` on this machine with the local Helix binary
-  (`MUTAGENT_HELIX_BIN` selects one) and creates nothing in the workspace.
+  (`mutagent install helix` puts one at `~/.mutagent/bin/helix`; `MUTAGENT_HELIX_BIN` selects another) and creates nothing in the workspace.
 - Compilation requires Bun 1.3.14 on `PATH` or `MUTAGENT_BUN_BIN`.
 
-### Lifecycle Meta-Installer (`install`)
+### Helix Installer (`install`)
 
 ```bash
-mutagent install diagnostics        # Install @mutagent/diagnostics from npm (login-gated)
-mutagent install evaluator          # Install @mutagent/evaluator from npm
-mutagent install evaluator --version 1.2.3   # Pin a specific version
-mutagent install helix              # Self-hosted install (may return NOT_IMPLEMENTED — pending)
+mutagent install helix                       # latest channel
+mutagent install helix --channel candidate   # candidate channel
+mutagent install helix --json                # binaryPath, version, sha256, onPath, pathLine
 ```
 
-| Package | Source | Notes |
-|---------|--------|-------|
-| `diagnostics` | public npm | Installs today |
-| `evaluator` | public npm | Installs today |
-| `helix` | self-hosted | Pending — may return `NOT_IMPLEMENTED` for now |
+`mutagent install helix` does what `curl -fsSL https://install.mutagent.io/helix | bash`
+does: it downloads `helix-<os>-<arch>` (macOS or Linux, x64 or arm64) from
+`https://install.mutagent.io/<channel>/`, verifies it against `checksums.txt` from the
+same origin, writes `~/.mutagent/bin/helix` with the `mutagent-helix` alias, and runs
+`helix --version`. No login is needed. Shell rc files are never changed: when the
+directory is not on `PATH`, the line to add is printed. When you are signed in, the
+CLI also records the install activation, best-effort; `--json` reports it as
+`telemetry` (`sent`, `skipped` or `failed`).
+
+| Environment variable | Effect |
+|---|---|
+| `MUTAGENT_HELIX_CHANNEL` | `latest` or `candidate` when `--channel` is not passed |
+| `MUTAGENT_INSTALL_HOST` | Install host (default `https://install.mutagent.io`) |
+| `MUTAGENT_INSTALL_DIR` | Install directory (default `~/.mutagent/bin`) |
+
+`diagnostics` and `evaluator` are not install targets: both skills ship inside helix.
 
 ### Feedback (`feedback`)