The open-source reference library for cloud cost operations. A curated set of specialist AI agent personas and named-pattern playbooks that drop into any modern coding assistant -- Claude Code, OpenAI Codex CLI, Gemini CLI, GitHub Copilot, Cursor, Windsurf, Aider, and OpenCode -- plus ChatGPT Custom GPTs, Claude Projects, and Gemini Gems on the web.
Built by Cletrics and the FinOps community. MIT-licensed. Vendor-neutral where possible. Contributions welcome.
Framework-aligned. 22 of 22 Capabilities covered (100%). Every
agent carries explicit
FinOps Framework metadata -- Domain,
Capability, Phase, Personas, Maturity entry point -- and references a
shared doctrine layer (Iron Triangle, Data in the Path,
Crawl/Walk/Run, FCP Canon Anchors). See
fcp-coverage.md for the live matrix, or run
./scripts/fcp-coverage.sh.
Cloud cost operations is a practice: tagging, allocation, forecasting, commitment management, waste detection, unit economics, and the human cadences that tie them together. It's also full of specialized knowledge -- CUR schema quirks, GCP SUD dynamics, Azure enrollment types, Kubernetes attribution math -- that every team ends up re-learning from scratch.
This repo packages that knowledge as agent personas your coding assistant can load on demand. Instead of "help me write a BigQuery query for GCP billing," you ask the GCP Billing Interpreter agent, and it knows the schema, the credit model, and the common gotchas before you type the first line.
git clone https://github.com/cletrics/finops-agents.git
cd finops-agents
# Install for all detected tools
./scripts/install.sh
# Or pick one
./scripts/install.sh --tool claude-code
./scripts/install.sh --tool codex # OpenAI Codex CLI
./scripts/install.sh --tool gemini-cli # Gemini CLI (skill format)
./scripts/install.sh --tool copilot
./scripts/install.sh --tool cursor
./scripts/install.sh --tool windsurf
./scripts/install.sh --tool aider
./scripts/install.sh --tool opencode
./scripts/install.sh --tool chatgpt # prints Custom GPT / Projects bundle pathChatGPT Custom GPTs, Claude Projects, and Gemini Gems can load the agents
directly. See integrations/chatgpt/README.md
for setup instructions for each.
The installer only does local file copies into your tool's standard config directory. No network calls, no sudo, no elevated privileges.
Day-to-day cloud cost analysis across AWS, GCP, and Azure.
- AWS Cost Explorer Analyst -- CUR 2.0, Cost Categories, line-item narratives
- GCP Billing Interpreter -- detailed billing export, SUD/CUD, BigQuery queries
- Azure Cost Management Navigator -- EA / MCA, FOCUS export, management groups
- Multi-Cloud Cost Comparator -- unified FOCUS dataset across clouds
- Cost Anomaly Detector -- seasonal-aware detection that doesn't fire on Mondays
- Forecast Model Builder -- driver-based forecasts tied to business drivers
- Cloud Workload Cost Estimator -- pre-deployment modeling with sensitivity ranges
- FinOps Benchmarking Analyst -- KPI selection + internal + external comparison
- Unit Economics Modeler -- cost per tenant, per request, per GB
- Budget Alert Tuner -- fewer, sharper alerts teams actually action
Savings Plans, Reserved Instances, Committed Use Discounts, EDP negotiations.
- AWS Savings Plans Strategist
- AWS Reserved Instance Optimizer (RDS, ElastiCache, Redshift, DynamoDB)
- GCP CUD Optimizer
- Azure Reservation Planner
- EDP Negotiation Coach
Container-level attribution and autoscaling cost tuning.
- Kubernetes FinOps Engineer (OpenCost / Kubecost)
- Container Rightsizer (CPU/memory from Prometheus percentiles)
- Cluster Autoscaler Tuner (Karpenter, CAS, consolidation)
The pipelines and models behind every cost dashboard.
- CUR & FOCUS Data Engineer -- ingest and normalization
- Billing Data Pipeline Architect -- batch vs streaming, engine choice
- Cost Warehouse Modeler -- dimensional models, dbt, semantic layer
Practice operations: showback, chargeback, tagging, maturity, policy, tooling, enablement, migration, and cross-discipline coordination.
- Showback / Chargeback Architect
- Tag Hygiene Enforcer
- FinOps Governance Lead
- FinOps Practice Maturity Assessor
- Platform Team Cost Lead
- SRE SLO/Cost Tradeoff Analyst
- FinOps Policy Architect -- SCPs, Azure Policy, OPA, admission controllers
- FinOps Tooling Evaluator -- build-vs-buy, vendor selection, portfolio hygiene
- FinOps Enablement Lead -- training, Champions program, onboarding integration
- Cloud Onboarding Coordinator -- migration-time cost hygiene + intake gate
- FinOps Intersections Coordinator -- ITAM / ITSM / ITFM / Security / Sustainability liaison
The hunters.
- Idle Resource Hunter
- Zombie NAT Gateway Detector
- EBS Snapshot Gardener
- S3 Storage Class Auditor
- Cross-AZ Egress Investigator
- Orphaned Load Balancer Hunter
Higher-leverage niches.
- ML Workload Cost Optimizer (training / inference)
- Serverless Cost Profiler
- Spot Orchestrator
- Cloud Sustainability Analyst -- carbon accounting, region-carbon trade-offs
- License & SaaS Cost Optimizer -- BYOL, marketplace, entitlement audits
Named-pattern writeups for specific failure modes. Cite them by name.
Cloud resource waste:
Reporting / allocation / governance patterns (FCP-anchored):
- Untagged Spend Drift
- Month-Length Illusion -- the February "win" that isn't
- Masked Anomaly -- real cost blown in by a coincident commitment offset
- Chargeback Revolt -- skipping showback costs 12+ months of credibility
Claude Code
> Use the AWS Cost Explorer Analyst agent to audit last month's spend increases.
Cursor
Reference the Cost Anomaly Detector rule to design our alerting pipeline.
Any tool Reference the agent by name in a conversation. The agent's persona and rules become the working context for that task.
Cletrics builds real-time cloud cost observability for teams that want to stop waiting for yesterday's data. This repo is our open-source contribution to the FinOps community -- use it freely, with or without Cletrics the product.
See CONTRIBUTING.md. Pull requests welcome for new agents, new playbooks, tooling improvements, and localizations.
Please respect the 90/10 rule: agents and playbooks are generic FinOps resources. Product references stay minimal.
MIT. See LICENSE. Trademark and attribution terms in NOTICE.
"Cletrics" is a trademark of Cletrics. Fork freely; don't imply endorsement.
See SECURITY.md for the disclosure policy.