Skip to main content

​
MutagenT CLI

The MutagenT CLI (mutagent) is the primary developer interface for the MutagenT platform. It provides full access to prompt management, tracing, evaluations, and optimization - all from your terminal.
AI Agent Friendly - Use --json flag on any command for structured output. Use mutagent --help or mutagent <command> --help for progressive disclosure of available options.

​
Why CLI First?

AI Agent Integration

Designed for Claude Code and other AI assistants. The mutagent integrate command generates framework-specific SDK integration code.

Progressive Disclosure

Every command supports --help for detailed usage. AI agents can discover capabilities incrementally.

JSON Output

All commands support --json for machine-readable output, perfect for automation and AI parsing.

CI/CD Ready

Non-interactive authentication and scriptable commands for pipeline integration.

​
Command Structure

mutagent <command> [subcommand] [options]

​
Top-Level Commands

CommandDescription
mutagent authAuthentication management (login, logout, status)
mutagent configConfiguration management
mutagent promptsPrompt CRUD, datasets, evaluations, optimization
mutagent tracesTrace viewing and analysis
mutagent integrateGenerate framework integration code

​
Global Options

OptionDescription
--jsonOutput results as JSON (for AI agents and automation)
--api-key <key>Override API key for this command
--endpoint <url>Override API endpoint
--helpShow help for any command
--versionShow CLI version

​
Quick Start

# Install
bun add -g @mutagent/cli

# Authenticate
mutagent auth login

# List your prompts
mutagent prompts list

# Get integration code for your framework
mutagent integrate mastra

​
For AI Agents

When working with AI coding assistants like Claude Code: 
# Discover available commands
mutagent --help

# Get detailed help for a specific command
mutagent prompts --help
mutagent prompts optimize --help

# Get JSON output for parsing
mutagent --json prompts list
mutagent --json prompts get <id>

# Generate SDK integration code
mutagent integrate langchain --raw

​
What’s Next

Installation

Install and configure the CLI

Commands

Full command reference

Integrations

Generate framework integration code

MCP Mode

Run as MCP server for AI assistants