CLI Installation - MUTAGENT

The Mutagent CLI (@mutagent/cli) is published on npm.

Install

bun add -g @mutagent/cli

npm install -g @mutagent/cli

pnpm add -g @mutagent/cli

mutagent --version

mutagent login

Opens a browser to authorize the CLI. This is the normal path for local development.

Set the API key as an environment variable — no login step needed:

export MUTAGENT_API_KEY=mg_live_...

Managed keys use the mg_live_ prefix. See API Keys. You can also pass --non-interactive (or set CI=true) to suppress interactive prompts.

With MUTAGENT_API_KEY set, the CLI authenticates without mutagent login. This is the recommended pattern for CI pipelines and AI agents.

mutagent auth status

Requirement	Minimum	Notes
Bun	≥ 1.1	Recommended package runtime
Node.js	≥ 18	Alternative package runtime
OS	macOS · Linux · Windows	—

The CLI resolves configuration from flags, then environment variables, then your saved config. Set a default workspace or org to skip repeating them:

mutagent config set workspace <workspace-id>
mutagent config set org <org-id>

# inspect
mutagent config list
mutagent config get endpoint

bun remove -g @mutagent/cli

npm uninstall -g @mutagent/cli

To also remove saved credentials, delete ~/.config/mutagent.