- Updated: January 24, 2026
- 5 min read
Introducing AWS Doctor: Open‑Source CLI for AWS Cost Health Checks
AWS Doctor is an open‑source, terminal‑based health‑check utility that automatically diagnoses cost anomalies, detects idle AWS resources, and delivers actionable optimization insights directly from your command line.
Developers, DevOps engineers, cloud architects, and IT managers looking for a lightweight way to monitor and trim AWS spend can now leverage this tool without a Business or Enterprise support plan. The full source code and documentation are available on the AWS Doctor GitHub repository, where the community continuously contributes enhancements.
What Is AWS Doctor?
AWS Doctor is built with Go and acts as a comprehensive health‑check for any AWS account. It mirrors many of the recommendations you’d find in AWS Trusted Advisor, but it runs locally, requires no additional AWS support tier, and delivers results in a concise, terminal‑friendly format.
- Cost Comparison: Shows month‑over‑month spend for identical date ranges, giving a fair view of spending velocity.
- Waste Detection (the “Checkup”): Scans for “zombie” resources such as unattached EBS volumes, idle load balancers, and stale snapshots.
- Trend Analysis: Visualizes six‑month cost trends to surface long‑term anomalies.
- Multi‑profile Support: Works with any AWS profile configured in
~/.aws/credentials.
Because it runs locally, you keep full control of your credentials and data, making it a secure choice for regulated environments.
Installation & Quick‑Start Usage
Getting AWS Doctor up and running takes under two minutes on macOS, Linux, or Windows.
Step 1: Install the Binary
For macOS/Linux, run the one‑liner installer:
curl -sSfL https://raw.githubusercontent.com/elC0mpa/aws-doctor/main/install.sh | sh
Windows users can download the .exe from the Releases page and add it to their PATH.
Step 2: Verify the Installation
aws-doctor --help
The help output confirms the binary is ready and lists all available flags.
Step 3: Run a Basic Checkup
Execute a health check against your default profile:
aws-doctor --waste
The command returns a table of idle resources, such as:
- Unattached EBS volumes
- Elastic IPs without an associated instance
- Stopped EC2 instances older than 30 days
- Idle load balancers and NAT gateways
Advanced Flags
| Flag | Purpose |
|---|---|
--profile |
Select a specific AWS profile. |
--region |
Target a particular AWS region. |
--trend |
Show six‑month cost trend charts. |
--output json|table |
Choose between JSON or human‑readable table output. |
Why AWS Doctor Matters for Developers & Cloud Teams
In fast‑moving cloud environments, hidden costs can erode budgets within weeks. AWS Doctor delivers three core benefits that directly address the pain points of modern DevOps and cloud operations teams.
1. Immediate Cost Savings
By surfacing idle resources, the tool enables teams to de‑provision or right‑size assets within minutes, often saving 5‑15 % of monthly spend. For a typical mid‑size SaaS workload, that translates to thousands of dollars saved each quarter.
2. Proactive Health Checks
Instead of waiting for a surprise bill, you can schedule aws-doctor as a cron job or integrate it into CI/CD pipelines. The Workflow automation studio on UBOS makes it trivial to trigger the CLI, parse JSON output, and raise Slack alerts automatically.
3. Seamless Integration with Existing Toolchains
Because the output can be JSON, you can pipe results into monitoring platforms like Datadog, Grafana, or even the Enterprise AI platform by UBOS. This enables dashboards that track waste trends over time, turning raw data into strategic decisions.
Roadmap, Community, and How to Contribute
The project follows an open‑source governance model. Contributors are encouraged to open pull requests, file issues, or suggest new waste‑detection rules.
Upcoming Features (as of early 2026)
- Monthly trend analysis with predictive cost forecasting.
- Export of reports to CSV and PDF for compliance audits.
- Native packaging for Fedora, Ubuntu, and Homebrew.
- Extended support for AWS Savings Plans and Reserved Instances.
Community members can track progress on the GitHub Projects board and join discussions in the Discussions forum.
Related UBOS Resources to Supercharge Your AWS Workflow
UBOS offers a suite of tools that complement AWS Doctor, helping you build, monitor, and monetize AI‑enhanced cloud solutions.
- UBOS homepage – Overview of the platform and its low‑code capabilities.
- UBOS platform overview – Learn how to integrate custom CLI tools into a unified dashboard.
- AI marketing agents – Automate campaign creation based on cost‑saving insights.
- UBOS for startups – Tailored pricing and templates for early‑stage teams.
- UBOS solutions for SMBs – Scalable tools for small‑to‑medium businesses.
- UBOS pricing plans – Transparent pricing that aligns with your cloud spend.
- UBOS templates for quick start – Jump‑start projects like cost‑monitoring dashboards.
- UBOS portfolio examples – Real‑world case studies of AI‑driven cloud optimization.
For developers interested in AI‑enhanced analytics, the following marketplace templates are especially relevant:
- AI SEO Analyzer – Combine cost data with SEO insights for holistic digital strategy.
- AI Article Copywriter – Generate documentation or blog posts about your cloud savings automatically.
- AI Video Generator – Create quick explainer videos on how AWS Doctor reduced your spend.
- AI YouTube Comment Analysis tool – Monitor community feedback on your cost‑optimization initiatives.
- AI LinkedIn Post Optimization – Share your success stories with the right audience.
Conclusion – Take Control of Your AWS Bill Today
Whether you manage a single account or a sprawling multi‑region environment, AWS Doctor gives you the visibility and automation needed to keep cloud costs in check. Pair it with UBOS’s low‑code platform and AI‑driven templates to turn raw cost data into actionable business intelligence.
Ready to start saving?
Download AWS Doctor, run your first --waste scan, and then explore UBOS’s Web app editor on UBOS to build a custom dashboard that surfaces the most critical findings in real time.
Stay tuned to the project’s roadmap, contribute to the community, and watch your AWS spend shrink—one idle resource at a time.