A terminal-based tool that acts as a comprehensive health check for your AWS accounts. Built with Golang, aws-doctor diagnoses cost anomalies, detects idle resources, and provides a proactive analysis of your cloud infrastructure—effectively giving you the insights of AWS Trusted Advisor without the need for a Business or Enterprise support plan.
- 📉 Cost Comparison: Compares costs between the current and previous month for the exact same period (e.g., comparing Jan 1–15 vs Feb 1–15) to give a fair assessment of spending velocity.
- 🏥 Waste Detection (The "Checkup"): Scans your account for "zombie" resources and inefficiencies that are silently inflating your bill.
- 📊 Trend Analysis: Visualizes cost history over the last 6 months to spot long-term anomalies.
As a Cloud Architect, I often need to check AWS costs and billing information. While the AWS Console provides raw data, it lacks the immediate context I need to answer the question: "Are we spending efficiently?"
I created aws-doctor to fill that gap. It doesn't just show you the bill; it acts as a diagnostic tool that helps you understand where the money is going and what can be cleaned up. It automates the routine checks I used to perform manually, serving as a free, open-source alternative to the paid recommendations found in AWS Trusted Advisor.
curl -sSfL https://raw.githubusercontent.com/elC0mpa/aws-doctor/main/install.sh | shgo install github.com/elC0mpa/aws-doctor@latestDownload the latest release for your platform from the Releases page.
Available platforms:
- macOS (Intel & Apple Silicon)
- Linux (amd64 & arm64)
- Windows (amd64)
Tip
Once installed, you can keep aws-doctor up to date by running aws-doctor --update.
--profile: Specify the AWS profile to use (default is "").--region: Specify the AWS region to use. If not provided, usesAWS_REGIONorAWS_DEFAULT_REGIONenvironment variables, or the region from~/.aws/config.--trend: Shows a trend analysis for the last 6 months.--output: Output format:table(default) orjson.--waste: Makes an analysis of possible money waste you have in your AWS Account.- Unused EBS Volumes (not attached to any instance).
- EBS Volumes attached to stopped EC2 instances.
- Unassociated Elastic IPs.
- EC2 reserved instance that are scheduled to expire in the next 30 days or have expired in the preceding 30 days.
- EC2 instance stopped for more than 30 days.
- Load Balancers with no attached target groups.
- Unused AMIs (not associated with any running or stopped instance and created more than 90 days ago).
- Orphaned EBS Snapshots (source volume deleted and not used by any AMI).
- Stale EBS Snapshots (created more than 90 days ago, source volume exists and not used by any AMI).
- Inactive VPC interface endpoints.
- Inactive NAT Gateways.
- Idle Load Balancers.
- RDS Idle DB Instances.
--version: Display version information.--update: Updates the tool to the latest version.
- Add monthly trend analysis
- Add waste / wastage analysis logic
- Export reports to JSON format
- Export reports to CSV and PDF formats (medical records for your cloud)
- Distribute the CLI via Fedora, Ubuntu, and macOS repositories