LLM Router CLI Agent (llm-agent)

Terminal-native coding agent for LLM Router.

• Package: llm-agent-cli
• Commands: llm-agent and llm
• Runtime: Node.js >=20

Install

npm install -g llm-agent-cli
llm-agent --help

Authenticate

Browser login (recommended)

llm-agent login
llm-agent whoami

Environment variables

export LLM_ROUTER_BASE_URL="https://api.llm-router.dev"
export LLM_ROUTER_API_KEY="llr_prod_sk_..."
llm-agent

Run

# Interactive
llm-agent

# One-shot
llm-agent --prompt "Summarize this codebase"

# JSON output for scripts
llm-agent --prompt "List production risks" --output-format json

# Resume prior session
llm-agent --resume <session-id>

Permission Modes

# read-only
llm-agent --permissions safe

# prompted approvals (default)
llm-agent --permissions standard

# auto-approved writes/shell (use only in trusted sandboxes)
llm-agent --permissions yolo

Core Slash Commands

• /help
• /tools
• /models
• /cost
• /compact
• /save [name]
• /load [name]
• /lint [path]
• /test [path]
• /scan [path]
• /memory, /remember

Routing Behavior

CLI requests automatically send:

• X-Client-Type: cli-agent

This activates the router's deterministic CLI fast-path (agentic intent + tool-capable model preference), while keeping normal auth, rate limits, and billing enforcement.

Local Development

npm install
npm run build
npm test