@mutagent/cli 0.2.21 → 0.2.22

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 CHANGED
@@ -18,7 +18,7 @@
18
18
 
19
19
  MutagenT CLI is the command-line client for the MutagenT AI platform. It handles
20
20
  authentication, BYOK LLM providers, workspace Environments, managed agents, cloud
21
- sandboxes and Helix sessions, and the standalone Helix binary installer.
21
+ sandboxes and Helix sessions, and the Helix binary installer.
22
22
 
23
23
  **Status:** all commands and flags below were verified against `mutagent --help`
24
24
  (and each subcommand's `--help`) on this branch. `sandbox` is internal (everyday
@@ -47,7 +47,7 @@ For where the CLI sits relative to the rest of the platform, see the
47
47
  - **LLM providers (BYOK)**: configure and test your own provider keys (`mutagent providers`), or copy them from a local Helix login (`mutagent providers mirror`)
48
48
  - **Workspace Environments**: `mutagent env` holds the variables and secrets an agent's tools need, separate from LLM provider keys
49
49
  - **Managed agents**: `mutagent agent` checks, packages, deploys and runs `agent.md` folders; `mutagent helix agent @slug` runs a deployed one in the cloud
50
- - **Helix installer**: `mutagent install helix` installs the standalone Helix binary into `~/.mutagent/bin` (no login needed)
50
+ - **Helix installer**: `mutagent install helix` installs the Helix binary into `~/.mutagent/bin` (no login needed)
51
51
  - **Claude Code integration**: install the CLI skill (`mutagent skills install`) and session-telemetry hooks (`mutagent hooks install`)
52
52
  - **Built-in feedback**: `mutagent feedback send` reports bugs and product feedback, optionally with your coding-agent session transcript
53
53
 
package/dist/bin/cli.js CHANGED
@@ -23273,7 +23273,7 @@ name: mutagent-cli
23273
23273
  description: |
23274
23274
  Mutagent CLI - the command-line client for the Mutagent platform.
23275
23275
  Guides coding agents through setup (login, init, providers, workspaces),
23276
- installing the standalone Helix binary, and sending
23276
+ installing Helix, and sending
23277
23277
  product feedback, and deploying and running managed agents (agent.md folders).
23278
23278
  Triggers: "mutagent", "mutagent cli", "mutagent login", "set up mutagent",
23279
23279
  "install diagnostics", "install evaluator", "install helix", "mutagent install",
@@ -23407,7 +23407,7 @@ skill never inlines flags. The active surface:
23407
23407
  | \`usage\` | Show usage + quota | [workflows/setup.md](./workflows/setup.md) |
23408
23408
  | \`skills install\` | Install this skill into a project | [workflows/setup.md](./workflows/setup.md) |
23409
23409
  | \`hooks install\` | Install Claude Code telemetry hooks | [workflows/setup.md](./workflows/setup.md) |
23410
- | \`install helix\` | Install the standalone Helix binary (diagnostics / evaluator are retired) | [workflows/install.md](./workflows/install.md) |
23410
+ | \`install helix\` | Install the Helix binary (diagnostics / evaluator are retired) | [workflows/install.md](./workflows/install.md) |
23411
23411
  | \`agent\` | Check, pack, run locally, deploy, activate, list, inspect and retire managed agents | [workflows/agent-deployment.md](./workflows/agent-deployment.md) |
23412
23412
  | \`feedback send\` | Send product feedback | [workflows/feedback.md](./workflows/feedback.md) |
23413
23413
 
@@ -23432,7 +23432,7 @@ Match the user's first request. Load ONLY the matching subfile per the table. Do
23432
23432
  | User said / signal detected | Load subfile | Why |
23433
23433
  |---|---|---|
23434
23434
  | "log in", "authenticate", "set up mutagent", "init", "which workspace", "what models", "usage", "quota", "install the skill", "install hooks" | [workflows/setup.md](./workflows/setup.md) | Auth + project setup + discovery commands |
23435
- | "install helix", "install diagnostics", "install evaluator", "add mutagent package" | [workflows/install.md](./workflows/install.md) | Standalone Helix binary installer, no login (diagnostics/evaluator are retired → helix) |
23435
+ | "install helix", "install diagnostics", "install evaluator", "add mutagent package" | [workflows/install.md](./workflows/install.md) | Helix binary installer, no login (diagnostics/evaluator are retired → helix) |
23436
23436
  | "agent.md", "deploy agent", "managed agent", "mutagent agent", "helix agent @slug" | [workflows/agent-deployment.md](./workflows/agent-deployment.md) | agent.md folder → check → deploy to a slot → run with \`helix agent @slug\` |
23437
23437
  | "send feedback", "report a bug", "file feedback", "the CLI crashed" | [workflows/feedback.md](./workflows/feedback.md) | Product feedback (+ optional transcript) |
23438
23438
  | Unclear / first time | run \`mutagent --help --json\` then reroute | Discover the surface before acting |
@@ -23444,7 +23444,7 @@ Match the user's first request. Load ONLY the matching subfile per the table. Do
23444
23444
  | File | WHEN to load | WHY |
23445
23445
  |---|---|---|
23446
23446
  | [workflows/setup.md](./workflows/setup.md) | User is onboarding: login, init, config, workspaces, providers, usage, skill/hooks install | Auth + configuration + discovery |
23447
- | [workflows/install.md](./workflows/install.md) | User wants to install Helix | \`install helix\`: the standalone binary into ~/.mutagent/bin |
23447
+ | [workflows/install.md](./workflows/install.md) | User wants to install Helix | \`install helix\`: the Helix binary into ~/.mutagent/bin |
23448
23448
  | [workflows/agent-deployment.md](./workflows/agent-deployment.md) | User wants to deploy or run a managed agent, or run an agent.md locally | Slots (\`--env\`), revisions (\`vN\`), \`@slug\` runs, rollback and retire |
23449
23449
  | [workflows/feedback.md](./workflows/feedback.md) | User wants to send feedback or report a bug | \`feedback send\` + \`--attach-transcript\` |
23450
23450
 
@@ -23673,8 +23673,8 @@ how they learn something sensitive was in the file at all.
23673
23673
  "workflows/install.md": `---
23674
23674
  name: mutagent-cli-workflows-install
23675
23675
  description: |
23676
- Install workflow. \`mutagent install helix\` installs the standalone Helix
23677
- binary into ~/.mutagent/bin, the same result as
23676
+ Install workflow. \`mutagent install helix\` installs the Helix binary
23677
+ into ~/.mutagent/bin, the same result as
23678
23678
  \`curl -fsSL https://install.mutagent.io/helix | bash\`. No login needed.
23679
23679
  \`diagnostics\` and \`evaluator\` are RETIRED as install targets — both skills
23680
23680
  now ship inside helix.
@@ -23691,7 +23691,7 @@ triggers:
23691
23691
  # Workflow — Install Helix
23692
23692
 
23693
23693
  > **\`helix\` is the only install target.** \`mutagent install helix\` installs the
23694
- > standalone Helix binary at \`~/.mutagent/bin/helix\`, the same result as
23694
+ > Helix binary (the Helix harness) at \`~/.mutagent/bin/helix\`, the same result as
23695
23695
  > \`curl -fsSL https://install.mutagent.io/helix | bash\`.
23696
23696
  >
23697
23697
  > \`diagnostics\` and \`evaluator\` are **retired** — their npm packages are no
@@ -24003,7 +24003,7 @@ confirm before running (Core Rule 5).
24003
24003
  ## Cross-references
24004
24004
 
24005
24005
  - [SKILL.md](../SKILL.md) → Core Rules + Task Router
24006
- - [workflows/install.md](./install.md) → install the standalone Helix binary (diagnostics / evaluator are retired)
24006
+ - [workflows/install.md](./install.md) → install the Helix binary (diagnostics / evaluator are retired)
24007
24007
  `
24008
24008
  };
24009
24009
  var SKILL_CONTENT = SKILL_FILES["SKILL.md"] ?? "";
@@ -24187,7 +24187,7 @@ It never prompts. Without a sign-in it exits 3 (AUTH_REQUIRED) and names the sig
24187
24187
  } else {
24188
24188
  console.log("");
24189
24189
  console.log(chalk17.bold(` What's next:`));
24190
- console.log(` ${chalk17.cyan("mutagent install helix".padEnd(30))}${chalk17.dim("# the standalone Helix binary")}`);
24190
+ console.log(` ${chalk17.cyan("mutagent install helix".padEnd(30))}${chalk17.dim("# the Helix binary")}`);
24191
24191
  console.log("");
24192
24192
  console.log(chalk17.dim(" Your coding agent now knows these workflows — restart it to pick up"));
24193
24193
  console.log(chalk17.dim(' the skill, then just say "set up Mutagent on this project".'));
@@ -25493,7 +25493,7 @@ var BY_DESIGN_ENTRIES = [
25493
25493
  id: "mutagent-helix-not-on-npm",
25494
25494
  title: "@mutagent/helix is not published to npm — on purpose",
25495
25495
  looksLike: pairPatterns(HELIX_PKG, NOT_FOUND),
25496
- reality: "Helix is not distributed through the public npm registry, so a 404 there is expected. It ships as a standalone binary from install.mutagent.io, verified against the checksums published beside it. Install it with: mutagent install helix"
25496
+ reality: "Helix is not distributed through the public npm registry, so a 404 there is expected. It ships as the Helix binary from install.mutagent.io, verified against the checksums published beside it. Install it with: mutagent install helix"
25497
25497
  },
25498
25498
  {
25499
25499
  id: "trace-lives-in-a-different-binary",
@@ -25818,13 +25818,13 @@ init_errors();
25818
25818
  import { Command as Command12 } from "commander";
25819
25819
  import chalk23 from "chalk";
25820
25820
  function createInstallCommand(deps) {
25821
- const install = new Command12("install").description("Install the standalone Helix binary on this machine").argument("<package>", `Package to install: ${VALID_PACKAGES.join(", ")}`).option("--channel <channel>", `Release channel: ${HELIX_CHANNELS.join(" or ")} (default: latest)`).addHelpText("after", `
25821
+ const install = new Command12("install").description("Install the Helix binary on this machine").argument("<package>", `Package to install: ${VALID_PACKAGES.join(", ")}`).option("--channel <channel>", `Release channel: ${HELIX_CHANNELS.join(" or ")} (default: latest)`).addHelpText("after", `
25822
25822
  ${chalk23.bold("Examples:")}
25823
25823
  ${chalk23.dim("$")} mutagent install helix
25824
25824
  ${chalk23.dim("$")} mutagent install helix --channel candidate
25825
25825
  ${chalk23.dim("$")} mutagent install helix --json
25826
25826
 
25827
- ${chalk23.bold("helix")}: the standalone Helix binary, the same one
25827
+ ${chalk23.bold("helix")}: the Helix binary (the Helix harness), the same one
25828
25828
  \`curl -fsSL https://install.mutagent.io/helix | bash\` installs. It downloads
25829
25829
  helix-<os>-<arch> for macOS or Linux (x64, arm64), verifies it against
25830
25830
  checksums.txt from the same origin, writes ~/.mutagent/bin/helix and points the
@@ -30212,7 +30212,7 @@ function createHelixCommand() {
30212
30212
  " Choose -p (one-shot), --mode json or --mode rpc (a steerable session) explicitly.",
30213
30213
  " Without --prime the full Helix orchestrator runs; --prime runs the lean Prime agent.",
30214
30214
  " Keep the session reference (hs1_...) printed on stderr; attach, send, signal and checkpoint take it.",
30215
- " mutagent install helix installs the standalone Helix binary on this machine; this command runs it in the cloud.",
30215
+ " mutagent install helix installs the Helix binary on this machine; this command runs it in the cloud.",
30216
30216
  " Inside a git checkout, pass the git remote's owner/name to start with it checked out: --repository <owner/name> [--branch <name>].",
30217
30217
  " On a refusal, show the returned fix: the Run: lines, the notes, and who has to act; do not invent other commands.",
30218
30218
  " In --mode rpc/json a launch refusal is one JSON line on stderr: {success:false, code, error, suggestedAction,",
@@ -37860,7 +37860,7 @@ ${chalk64.yellow("Get started:")}
37860
37860
  ${chalk64.dim("Create an Environment: the variables and secrets a sandbox gets")}
37861
37861
  4. mutagent helix --env staging -p "<task>"
37862
37862
  ${chalk64.dim("Run Helix on the task in a cloud sandbox and print its answer")}
37863
- ${chalk64.dim("To run Helix on this machine instead: mutagent install helix installs the standalone binary")}
37863
+ ${chalk64.dim("To run Helix on this machine instead: mutagent install helix installs the Helix binary")}
37864
37864
 
37865
37865
  ${chalk64.yellow("Managed agents:")}
37866
37866
  mutagent agent deploy <agent.md> ${chalk64.dim("Check, upload and activate an agent.md folder (--env names the Environment whose slot is used)")}
@@ -37980,4 +37980,4 @@ if (process.env.CLI_VERSION) {
37980
37980
  }
37981
37981
  runCli(process.argv.slice(2), cliVersion);
37982
37982
 
37983
- //# debugId=6B702C81145D372764756E2164756E21
37983
+ //# debugId=A84F942DFD3F760E64756E2164756E21
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mutagent/cli",
3
- "version": "0.2.21",
3
+ "version": "0.2.22",
4
4
  "description": "Bun-native CLI for the MutagenT AI platform - auth, provider config, and lifecycle-tool installer for AI-native workflows",
5
5
  "type": "module",
6
6
  "bin": {