FinOps CLI

Cloud cost analysis and optimization tool. Scans AWS accounts (single or Organization with multiple accounts) for cost data and resources, stores everything locally in SQLite, and generates reports with trend analysis, anomaly detection, and period comparisons.

Prerequisites

• The finops binary must be installed and available in PATH
• Valid AWS credentials configured (via environment variables, AWS profiles, or IAM roles)
• AWS permissions needed: ce:GetCostAndUsage, sts:GetCallerIdentity, organizations:DescribeOrganization, organizations:ListAccounts, and read-only access to EC2, RDS, S3, Lambda, ECS, EKS, ElastiCache, CloudFront for resource discovery

Core Workflow

The CLI follows a scan → report → analyze pattern:

1. Scan — Download cost data and discover resources from AWS into local SQLite
2. Report — Generate reports from the local database (never calls AWS APIs)
3. Analyze — Interpret JSON output to provide insights and recommendations

CRITICAL: Always use --output json --file - for report commands, and pipe through 2>/dev/null | sed '/^Report saved to:/d' to get clean JSON on stdout. The CLI prints a Report saved to: - status line to stdout after the JSON which will break JSON parsers if not stripped.