Skip to main content

​
CLI Installation

​
Install

bun add -g @mutagent/cli

​
Verify Installation

mutagent --version

​
Authenticate

​
Interactive Login

mutagent auth login
This will prompt for:
  • Endpoint (default: https://api.mutagent.io/v1)
  • API Key (get from MutagenT dashboard)

​
Non-Interactive Login

For CI/CD pipelines or scripted setup: 
mutagent auth login --api-key "sk_live_xxxx" --endpoint "https://api.mutagent.io/v1"

​
Environment Variables

export MUTAGENT_API_KEY="sk_live_xxxx"
export MUTAGENT_ENDPOINT="https://api.mutagent.io/v1"

​
Check Status

mutagent auth status

​
System Requirements

RequirementVersion
Bun1.1.0+
Node.js18.0+ (alternative)
OSmacOS, Linux, Windows

​
Configuration

The CLI uses a configuration hierarchy (highest to lowest priority):
  1. Command-line flags (--api-key, --endpoint)
  2. Environment variables (MUTAGENT_API_KEY, MUTAGENT_ENDPOINT)
  3. Credentials file (~/.config/mutagent/credentials.json)
  4. RC files (.mutagentrc, .mutagentrc.json, mutagent.config.js)
  5. Global config (~/.config/mutagent/config.json)

​
Configuration File Example

Create .mutagentrc.json in your project: 
{
  "endpoint": "https://api.mutagent.io/v1",
  "format": "table",
  "timeout": 30000,
  "ui": {
    "colors": true,
    "verbosity": "info"
  }
}
Or mutagent.config.js: 
module.exports = {
  endpoint: 'https://api.mutagent.io/v1',
  format: 'table',
  ui: {
    colors: true,
    progressIndicators: true
  }
};

​
View Configuration

# List all config
mutagent config list

# Get specific value
mutagent config get apiKey
mutagent config get endpoint

​
Uninstall

bun remove -g @mutagent/cli
To also remove credentials: 
rm -rf ~/.config/mutagent