@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 +2 -2
- package/dist/bin/cli.js +15 -15
- package/package.json +1 -1
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
|
|
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
|
|
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
|
|
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
|
|
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) |
|
|
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
|
|
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
|
|
23677
|
-
|
|
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
|
-
>
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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=
|
|
37983
|
+
//# debugId=A84F942DFD3F760E64756E2164756E21
|
package/package.json
CHANGED