CLI

AI Spend and Governance in Your Terminal

Move from dashboards to action. Query LLM spend, review policy violations, manage virtual keys, and automate recurring checks from one CLI.

cloptima-cli demo
$ cloptima llm spend --window 30d --output table

$ cloptima llm breakdown --window 30d --group-by model --output json

$ cloptima llm policy-violations summary --since-days 7 --output json

$ cloptima llm gateway-keys list --output table

Common Workflows

Get Visibility Fast

Confirm access, check this month's LLM spend, and see your managed credit balance.

cloptima auth statuscloptima llm spend --window 30dcloptima llm credits

Understand What Is Driving Spend

Break spend down by model, team, or app, and see how it moves over time.

cloptima llm breakdown --window 30d --group-by modelcloptima llm breakdown --window 30d --group-by team_idcloptima llm spend-series --window 7d --group-by provider

Review Governance

See which requests policies blocked, which rules fire most, and which alerts are still open.

cloptima llm policy-violations listcloptima llm policy-violations summary --since-days 7cloptima llm alerts list

Automate Checks

Use structured output in CI pipelines, scripts, dashboards, or AI workflows.

cloptima llm spend --window 24h --output jsoncloptima llm policy-violations summary --output jsoncloptima llm showback export --output jsoncloptima mcp serve

Popular Commands

Spend and Attribution

Inspect LLM spend, check how much of it is attributed, and report cost per unit of work.

cloptima llm breakdown --window 30d --group-by app_idcloptima llm attribution-qualitycloptima llm unit-economics report --unit-type ticket_resolved --group-by team_idcloptima llm showback export --group-by team_id,app_id

Governance and Audit

Review policy violations, guardrail profiles, approval requests, and the audit log.

cloptima llm policy-violations summarycloptima llm governance guardrails listcloptima llm governance approvals list --status pendingcloptima llm audit --actions policy_bypass

Keys and Edge Gateways

Issue and rotate virtual keys, and install edge gateways in your own network.

cloptima llm gateway-keys create --name support-copilot --app-id support-copilotcloptima llm gateway-keys rotate --id <id>cloptima llm edge listcloptima llm edge install --name edge-us-east --format helm

Pricing and Alerts

Manage contract price sheets, preview negotiated rates, and work through LLM alerts.

cloptima llm pricing listcloptima llm pricing preview-rates --input-json '{...}'cloptima llm alerts listcloptima llm alerts rules list

Structured Output

Use JSON, table, or CSV output depending on whether the result is for a human, a spreadsheet, or automation.

Built for Workflow Automation

Use the CLI in shell scripts, release pipelines, and operational checks without building custom cost-reporting glue.

Secure Token Auth

Use cloptima auth login for local keychain storage or set CLOPTIMA_ACCESS_TOKEN in CI.

Works with AI Tools

Run cloptima mcp serve for a local MCP server, or connect your AI agent directly to Cloptima's hosted MCP endpoint instead.

Fast & Lightweight

Single Go binary, no runtime dependencies. Distributed through Homebrew and Docker image tags.

Install

installation
# macOS / Homebrew
brew tap cloptima/tap
brew install cloptima-cli

# Authenticate and store locally in keychain
cloptima auth login

# CI/CD
export CLOPTIMA_ACCESS_TOKEN="your_pat_token"
cloptima llm spend --window 24h --output json
cloptima llm policy-violations summary --output json

# MCP (local stdio server)
cloptima mcp serve
cloptima mcp serve --read-only

# Docker
docker run --rm docker.io/cloptimaai/cloptima-cli:latest version

Need client config snippets? See Cloptima CLI MCP Setup.

FAQ

Questions teams ask

Try the CLI

Bring LLM FinOps, governed model access, and guardrails into one operating model.

Get Started
No credit card required
5-minute setup
Free plan