Introduction
spendlens is a read-only FinOps command line for AWS. It checks your estate against your company's standards, finds waste and puts a price on it, explains how your bill is changing, warns you about spikes and budget overruns, and answers questions in plain English.
What it does
| Area | Command | What you get |
|---|---|---|
| Tag compliance | spendlens tags |
Mandatory, untagged, prohibited, tag-limit and allowed-value checks across 70 resource types |
| Rightsizing & standards | spendlens rightsize |
Oversized or non-standard resources (instance families, gp2→gp3, Multi-AZ by environment, …) with a $ estimate |
| Waste | spendlens waste |
Unattached volumes, orphaned snapshots, idle load balancers and NAT gateways, unused EIPs and secrets, … |
| Cost analysis | spendlens cost diff / trend / showback / resources |
What changed between any two months or ranges, by service, account, region or tag |
| Anomalies & forecast | spendlens anomalies, spendlens forecast |
Daily spikes against a robust baseline; month-end projection against your budgets |
| Savings | spendlens savings hub / commitments / summary |
AWS Cost Optimization Hub recommendations, Savings Plan and RI coverage, and one de-duplicated total |
| Reports | spendlens dashboard, --format html |
A self-contained HTML dashboard, plus table, CSV, JSON or HTML output from every command |
| AI assistant | spendlens ask |
Questions answered from your data by Claude, OpenAI, Azure or any OpenAI-compatible model |
| Automation | spendlens report, spendlens notify, spendlens init --ci |
One-command runs, Slack and Teams summaries, scheduled GitLab and GitHub pipelines |
How it works, in one paragraph
spendlens uses Steampipe to expose AWS APIs as SQL tables and Powerpipe to run its bundled controls. Your standards live in one finops.yaml. Every run is saved to a local SQLite history, so dashboards, notifications, "what changed since last week" and the AI assistant work offline from data already collected. See Architecture for the diagrams.
Principles
- Read-only. spendlens never creates, modifies, tags or deletes resources. Savings are proposals for a human to review.
- Your credentials, nothing stored. It uses whatever AWS role your terminal or CI has already assumed.
- Your standards. Every threshold is a parameter, set in
finops.yaml, through environment variables, or with--seton any command. - Try before you connect. Every command accepts
--source demoand runs against bundled sample data.
Next: Getting started.