@mutagent/cli 0.1.349 → 0.1.351

package/README.md

@@ -24,7 +24,7 @@
 </p>
 
 <p align="center">
-  <strong>Authenticate. Configure providers. Install Helix.</strong>
+  <strong>Authenticate. Configure LLM providers. Install Helix.</strong>
 </p>
 
 ---
@@ -42,9 +42,9 @@ drive the CLI without human hand-holding.
 
 ### Key Features
 
-- **AI-First Design**: Every command supports `--json` with `_directive` + `_links` for programmatic use by coding agents
+- **For scripts and agents**: commands support `--json` with `_directive` and `_links`. A `mutagent helix` run prints Helix's own output; `--json` does not change it
 - **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`)
+- **LLM providers (BYOK)**: Configure and test your own LLM provider keys (`mutagent providers`)
 - **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
@@ -87,7 +87,7 @@ flowchart TD
             USAGE["mutagent usage"]
         end
 
-        subgraph PROVIDER_CMDS ["Providers (BYOK)"]
+        subgraph PROVIDER_CMDS ["LLM providers (BYOK)"]
             PROV_LIST["mutagent providers list"]
             PROV_ADD["mutagent providers add"]
             PROV_TEST["mutagent providers test <id>"]
@@ -169,12 +169,12 @@ mutagent init --non-interactive   # CLI-only defaults, no prompts
 mutagent auth status
 ```
 
-### 3. Configure Providers (BYOK)
+### 3. Configure LLM providers (BYOK)
 
 ```bash
-mutagent providers list                 # List configured providers
-mutagent providers list --models        # Show available models per provider
-mutagent providers add                  # Add a provider key (interactive)
+mutagent providers list                 # List configured LLM providers
+mutagent providers list --models        # Show available models per LLM provider
+mutagent providers add                  # Add an LLM provider key (prompts for values)
 mutagent providers test <provider-id>   # Verify connectivity
 ```
 
@@ -259,16 +259,16 @@ mutagent workspaces list --limit 20 --offset 0
 mutagent workspaces get <id>        # Workspace details
 ```
 
-### Providers (`providers`, BYOK)
+### LLM providers (`providers`)
 
 ```bash
-mutagent providers list             # List configured providers
-mutagent providers list --models    # Show available models per provider
-mutagent providers get <id>         # Provider details
-mutagent providers test <id>        # Test provider connectivity
+mutagent providers list             # List configured LLM providers
+mutagent providers list --models    # Show available models per LLM provider
+mutagent providers get <id>         # LLM provider details
+mutagent providers test <id>        # Test LLM provider connectivity
 
 # Manage keys
-mutagent providers add              # Add a provider (interactive; --scope, --base-url, --set-default)
+mutagent providers add              # Add an LLM provider (prompts for values; --scope, --base-url, --set-default)
 mutagent providers update <id> --name "New name" --active true
 mutagent providers delete <id> --force
 ```
@@ -276,7 +276,7 @@ mutagent providers delete <id> --force
 ### Usage (`usage`)
 
 ```bash
-mutagent usage                      # Show account usage + provider status
+mutagent usage                      # Show account usage + LLM provider status
 mutagent usage --json               # Machine-readable
 ```
 
@@ -470,7 +470,7 @@ The two trees authenticate differently.
 | `helix session start <sandbox-id>` (internal) | `POST /api/sandbox/:id/session` `{mode, args?, cwd?, environment?}` | `commands/helix/session-commands.ts:139-150` → `lib/sandbox-api.ts:741-749` |
 | `helix models` | `GET /api/sandbox/helix/defaults` | `commands/helix/models.ts:85` → `lib/sandbox-api.ts:780-781` |
 | `helix models default <ids…>`, `--clear` | `PUT /api/sandbox/helix/defaults` `{models}` (`--clear` sends `[]`) | `commands/helix/models.ts:138` → `lib/sandbox-api.ts:785-787` |
-| `helix doctor`, `helix smoke` | `POST /api/sandbox/run` (fresh preset box, torn down after), or `POST /api/sandbox/:id/exec` with `--sandbox` | `commands/helix/doctor.ts:135`, `:179`, `:308-327` → `lib/sandbox-api.ts:692-693`, `:753-754` |
+| `helix doctor`, `helix smoke` | `POST /api/sandbox/run` (fresh preset sandbox, torn down after), or `POST /api/sandbox/:id/exec` with `--sandbox` | `commands/helix/doctor.ts:135`, `:179`, `:308-327` → `lib/sandbox-api.ts:692-693`, `:753-754` |
 | `helix version` | `GET /api/sandbox/presets` | `commands/helix/doctor.ts:263-268`, `:301-302` → `lib/sandbox-catalog.ts:34` |
 | `helix update` | `GET /api/sandbox/presets` to name the pinned version, then exit 2 | `commands/helix/doctor.ts:210-220` |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutagent/cli",
-  "version": "0.1.349",
+  "version": "0.1.351",
   "description": "Bun-native CLI for the MutagenT AI platform - auth, provider config, and lifecycle-tool installer for AI-native workflows",
   "type": "module",
   "bin": {
@@ -42,7 +42,7 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.7.2",
-    "@mutagent/sdk": "0.5.10",
+    "@mutagent/sdk": "0.5.11",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "cosmiconfig": "^9.0.0",