Use Homebrew: brew tap cloptima/tap && brew install cloptima-cli. You can also run it via Docker from docker.io/cloptimaai/cloptima-cli:latest.

Can I use it in CI/CD?

Yes. Set CLOPTIMA_ACCESS_TOKEN in your CI secrets and run commands with --output json to power checks, reports, and cost guardrails in your pipeline.

What can I do beyond basic cost queries?

Teams commonly use the CLI to monitor onboarding health, investigate anomalies, review recommendations, break down Kubernetes spend, check budget and billing health, and automate recurring cost checks.

Does it work with AI agents?

Yes. Start cloptima mcp serve and connect your MCP client to the local process, or call CLI commands directly with JSON output in agent workflows.

New

Cost Intelligence in Your Terminal

Move from dashboards to action. Explore spend, investigate anomalies, analyze Kubernetes costs, and automate recurring cost workflows from one CLI.

$ cloptima accounts list

ID                                   Name         Provider  Status
11111111-2222-3333-4444-555555555555 prod-aws     AWS       ACTIVE
66666666-7777-8888-9999-000000000000 analytics    GCP       ACTIVE

$ cloptima costs dashboard --output table

$ cloptima k8s costs --cluster-id aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --days 7 --granularity daily --group-by namespace --output json

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

$ cloptima recommendations stats --cloud-account-id 11111111-2222-3333-4444-555555555555 --output json

Common Workflows

Get Visibility Fast

Confirm access, check onboarding health, and get a quick view of current cost signals.

cloptima accounts listcloptima status --cloud-account-id <id>cloptima overview

Understand What Is Driving Spend

Explore overall spend, compare trends over time, and identify where costs are moving.

cloptima costs --start-date YYYY-MM-DD --end-date YYYY-MM-DDcloptima costs dashboardcloptima costs trends --cloud-account-id <id>

Investigate Kubernetes Costs

Break down cluster spend, inspect workloads, and surface optimization opportunities.

cloptima k8s clusterscloptima k8s workloads --cluster-id <id>cloptima k8s costs --cluster-id <id> --days 7 --group-by namespacecloptima k8s recommendations --cluster-id <id>

Automate Guardrails

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

cloptima anomalies --cloud-account-id <id> --output jsoncloptima recommendations stats --cloud-account-id <id> --output jsoncloptima costs dashboard --output jsoncloptima mcp serve

Popular Commands

Cloud Cost Analysis

Inspect spend trends, compare time windows, and move from a summary view into deeper analysis.

cloptima overviewcloptima costs dashboardcloptima costs --start-date YYYY-MM-DD --end-date YYYY-MM-DDcloptima costs trends --cloud-account-id <id>

Savings and Risk Detection

Use the CLI to investigate unusual spend and identify optimization opportunities.

cloptima anomalies --cloud-account-id <id>cloptima anomalies stats --cloud-account-id <id>cloptima recommendations --cloud-account-id <id>cloptima recommendations stats --cloud-account-id <id>

Kubernetes Cost Workflows

Break down cluster spend, inspect workloads, and review Kubernetes-specific recommendations.

cloptima k8s clusterscloptima k8s workloads --cluster-id <id>cloptima k8s costs --cluster-id <id> --days 7 --group-by namespacecloptima k8s recommendations --cluster-id <id>

Advanced Operational Workflows

Go beyond explorer queries into budget monitoring, billing health, team views, and automation.

cloptima budgets listcloptima billing reconciliation-summarycloptima teams costs --start-time ... --end-time ...cloptima llm breakdown --window 30d --group-by model

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 and connect supported AI tools without standing up separate infrastructure.

Fast & Lightweight

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

Install

# 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 costs dashboard --output json
cloptima billing reconciliation-summary --output json
cloptima tags catalog --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

Try the CLI

Bring LLM FinOps, governed model access, and cloud cost optimization into one operating model.

Get Started

No credit card required

5-minute setup

30-day trial