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.
Tip
View the full documentation, permissions guide, and usage examples at awsdoctor.compacompila.com
Supports selective scanning: aws-doctor --waste ec2,s3
Homebrew (macOS/Linux):
brew install elC0mpa/homebrew-tap/aws-doctorOne-Line Script (macOS/Linux):
curl -sSfL https://raw.githubusercontent.com/elC0mpa/aws-doctor/main/install.sh | shUsing Go:
go install github.com/elC0mpa/aws-doctor@latest- 📉 Fair Cost Comparison: Compares identical time windows between months to spot real anomalies.
- 🧟 Zombie Discovery: Scans for idle EIPs, stopped instances, orphaned snapshots, and more. Supports selective service filtering (
ec2,s3,elb). - 📊 6-Month Trends: High-fidelity ANSI visualization of your spending velocity.
- 🔐 MFA Ready: Native support for profiles requiring Multi-Factor Authentication.
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.
We love contributions! Whether it's a new detection rule or a bug fix, check our Community Dashboard to get started.