Commands - MUTAGENT

Every command supports --json for structured output and --non-interactive to suppress prompts (CI=true does the same). Run mutagent <command> --help for flags and examples.

Account

Command	Description
`mutagent login`	Sign in — browser OAuth. Alias for `auth login`.
`mutagent auth login`	Sign in (`--browser`, `--non-interactive`, `--endpoint`).
`mutagent auth status`	Show the current authentication state.
`mutagent auth logout`	Sign out and clear credentials.
`mutagent config list`	Show the resolved configuration.
`mutagent config get <key>`	Read a config value.
`mutagent config set workspace <id>`	Set the default workspace.
`mutagent config set org <id>`	Set the default organization.
`mutagent workspaces list`	List your workspaces.
`mutagent workspaces get <id>`	Show a workspace’s details.

Providers

Manage LLM providers (BYOK). A provider belongs to one workspace — the one you are configured for. There is no scope to select and nothing is inherited, so no command here takes a scope.

Command	Description
`mutagent providers list`	List the workspace’s providers (`--limit`, `--offset`, `--type`, `--models`).
`mutagent providers get <id>`	Show a provider. The key comes back masked.
`mutagent providers add`	Add a provider.
`mutagent providers update <id>`	Update a provider (`--name`, `--api-key`, `--base-url`, `--active`, `--set-default`).
`mutagent providers delete <id>`	Remove a provider (`--force` to skip the prompt).
`mutagent providers test <id>`	Re-run the connection test against the live provider.

`providers add`

--provider, --name and --api-key are always required. The rest apply only to the entries that need them — see provider setup for which fields each entry takes.

Flag	Description
`-p, --provider <type>`	The catalog entry. One of `openai`, `anthropic`, `google`, `moonshot`, `glm`, `deepseek`, `xai`, `azure`, `vertex`, `bedrock`, `custom`.
`-n, --name <name>`	Display name for this configuration.
`-k, --api-key <key>`	The entry’s secret.
`--hosted-family <family>`	Which model family a gateway configuration targets. Required for gateways hosting more than one.
`--base-url <url>`	Custom base URL for the provider API.
`--resource-endpoint <url>`	Azure resource endpoint.
`--deployment-name <name>`	Azure deployment name.
`--api-version <version>`	Azure API version, e.g. `2024-08-01-preview`.
`--project-id <id>`	Google Vertex project ID.
`--region <region>`	Vertex location, or AWS Bedrock region.
`--set-default`	Set as the default provider of its kind.

# Direct entry
mutagent providers add --provider openai --name "My OpenAI" --api-key $OPENAI_API_KEY

# Gateway hosting two families — name the one this configuration is for
mutagent providers add --provider azure --name "Azure GPT" --api-key $AZURE_KEY \
  --hosted-family openai --resource-endpoint https://my-resource.openai.azure.com \
  --deployment-name my-gpt-deployment

The credential is checked against the live provider before it is stored. If the provider rejects it, nothing is saved and the provider’s own reason is shown.

Install

Install Mutagent packages into your coding agent. install takes a package and a harness.

Command	Description
`mutagent install helix`	Install the Helix orchestrator + lifecycle skills.
`mutagent install diagnostics`	Install the Diagnostics skill.
`mutagent install evaluator`	Install the Evaluator skill.

Flags: --harness HARNESS (one of claude-code, codex) to choose the coding agent, --global to install for all projects, --version to pin a version.

mutagent install helix --harness claude-code

Setup

Command	Description
`mutagent init`	Initialize a project (writes the local config).
`mutagent skills install`	Install the CLI’s own skill for coding agents.
`mutagent hooks install`	Install hook handlers for coding-agent telemetry.
`mutagent hooks claude-code <event>`	Install a specific Claude Code hook (session-start, pre/post-tool-use, stop, and more).

Usage

Command	Description
`mutagent usage`	Show your plan and current usage.

Feedback

Send product feedback to the Mutagent team straight from the CLI.

Command	Description
`mutagent feedback send <message>`	Send feedback.

Flag	Description
`--title TEXT`	A short title for the feedback.
`--category CATEGORY`	One of `cli`, `helix`, or `stage:` + a stage (`spec`, `build`, `evaluate`, `diagnose`, `optimize`).
`--session`	Attach the current session context.
`--attach-transcript [PATH]`	Attach a session transcript.

mutagent feedback send "The install step hung on Codex" --category cli --title "Install hang"

​Account

​Providers

​providers add

​Install

​Setup

​Usage

​Feedback

Account

Providers

`providers add`

Install

Setup

Usage

Feedback