GitHub - elC0mpa/aws-doctor: Diagnose AWS costs, detect idle resources, and optimize cloud spending directly from your terminal. 🩺 ☁️

Skip to content

Navigation Menu

Toggle navigation

Sign in

Appearance settings

PlatformAI CODE CREATIONGitHub CopilotWrite better code with AIGitHub SparkBuild and deploy intelligent appsGitHub ModelsManage and compare promptsMCP RegistryNewIntegrate external toolsDEVELOPER WORKFLOWSActionsAutomate any workflowCodespacesInstant dev environmentsIssuesPlan and track workCode ReviewManage code changesAPPLICATION SECURITYGitHub Advanced SecurityFind and fix vulnerabilitiesCode securitySecure your code as you buildSecret protectionStop leaks before they startEXPLOREWhy GitHubDocumentationBlogChangelogMarketplaceView all featuresSolutionsBY COMPANY SIZEEnterprisesSmall and medium teamsStartupsNonprofitsBY USE CASEApp ModernizationDevSecOpsDevOpsCI/CDView all use casesBY INDUSTRYHealthcareFinancial servicesManufacturingGovernmentView all industriesView all solutionsResourcesEXPLORE BY TOPICAISoftware DevelopmentDevOpsSecurityView all topicsEXPLORE BY TYPECustomer storiesEvents & webinarsEbooks & reportsBusiness insightsGitHub SkillsSUPPORT & SERVICESDocumentationCustomer supportCommunity forumTrust centerPartnersOpen SourceCOMMUNITYGitHub SponsorsFund open source developersPROGRAMSSecurity LabMaintainer CommunityAcceleratorArchive ProgramREPOSITORIESTopicsTrendingCollectionsEnterpriseENTERPRISE SOLUTIONSEnterprise platformAI-powered developer platformAVAILABLE ADD-ONSGitHub Advanced SecurityEnterprise-grade security featuresCopilot for BusinessEnterprise-grade AI featuresPremium SupportEnterprise-grade 24/7 supportPricing

Search or jump to...

Search code, repositories, users, issues, pull requests...

Search

Clear

Search syntax tips

Provide feedback

We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.
You signed out in another tab or window. Reload to refresh your session.
You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

elC0mpa

/

aws-doctor

Public

Notifications
You must be signed in to change notification settings

Fork
1

Star
95

Diagnose AWS costs, detect idle resources, and optimize cloud spending directly from your terminal. 🩺 ☁️

License

MIT license

95
stars

1
fork

Branches

Tags

Activity

Star

Notifications
You must be signed in to change notification settings

Code

Issues
1

Pull requests
0

Actions

Projects
0

Security

Uh oh!

There was an error while loading. Please reload this page.

Insights

Additional navigation options

Code

Issues

Pull requests

Actions

Projects

Security

Insights

elC0mpa/aws-doctor

 mainBranchesTagsGo to fileCodeOpen more actions menuFolders and filesNameNameLast commit messageLast commit dateLatest commit History20 Commitsdemodemo  modelmodel  serviceservice  utilsutils  .gitattributes.gitattributes  .gitignore.gitignore  LICENSELICENSE  README.mdREADME.md  app.goapp.go  go.modgo.mod  go.sumgo.sum  View all filesRepository files navigationREADMEMIT licenseaws-doctor
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.
Demo
Basic usage

Trend

Waste

Features

📉 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.

Motivation
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.
Installation
Golang

go install github.com/elC0mpa/aws-doctor@latest

Flags

--profile: Specify the AWS profile to use (default is "").
--region: Specify the AWS region to use (default is "us-east-1").
--trend: Shows a trend analysis for the last 6 months.
--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.
EC2 instances stopped for more than 30 days.
Load Balancers with no attached target groups.
Inactive VPC interface endpoints.
Inactive NAT Gateways.
Idle Load Balancers.
RDS Idle DB Instances.

Roadmap
[x] Add monthly trend analysis.
[x] Add waste/waste analysis logic.
[ ] Export reports to CSV and PDF formats (Medical records for your cloud).
[ ] Distribute the CLI in Fedora, Ubuntu, and macOS repositories.

About

Diagnose AWS costs, detect idle resources, and optimize cloud spending directly from your terminal. 🩺 ☁️

Topics

go

cli

golang

aws

aws-billing

aws-cli

aws-cost-explorer

aws-trusted-advisor

aws-doctor

Resources

Readme

License

MIT license

Uh oh!

There was an error while loading. Please reload this page.

Activity
Stars

95
stars
Watchers

1
watching
Forks

1
fork

Report repository

Releases
1

First Release

Latest

Jan 18, 2026

Packages
0

No packages published

Languages

Go
100.0%

Footer

© 2026 GitHub, Inc.

Footer navigation

Terms

Privacy

Security

Status

Community

Docs

Contact

Manage cookies

Do not share my personal information

You can’t perform that action at this time.

aws-doctor is a terminal-based command-line tool designed to help users diagnose and optimize AWS cloud spending by identifying cost inefficiencies, idle resources, and potential areas for savings. Developed by elC0mpa, the tool leverages Go (Golang) to provide a lightweight, open-source alternative to AWS Trusted Advisor’s paid features, enabling users to perform proactive cloud infrastructure analysis without requiring a Business or Enterprise support plan. The tool’s primary functions include cost comparison, waste detection, and trend analysis, offering actionable insights to improve cloud resource management. By automating routine checks that traditionally require manual effort, aws-doctor streamlines the process of evaluating AWS expenditures and identifying opportunities for optimization.

A core feature of aws-doctor is its ability to compare current month-to-month costs with the previous period, ensuring a fair assessment by aligning specific timeframes (e.g., January 1–15 versus February 1–15). This functionality helps users understand spending velocity and detect anomalies that might not be apparent through raw billing data alone. Additionally, the tool includes a “waste detection” module that scans AWS accounts for unused or underutilized resources, often referred to as “zombie” assets. These include unattached EBS volumes, EC2 instances with attached volumes that are not in use, unassociated Elastic IPs, and reserved EC2 instances nearing expiration. The tool also identifies inactive VPC interface endpoints, NAT gateways, load balancers without target groups, and idle RDS database instances. By flagging these inefficiencies, aws-doctor provides users with a clear roadmap for cleaning up unnecessary expenses and reallocating resources more effectively.

The trend analysis feature further enhances the tool’s utility by visualizing cost history over the past six months, allowing users to spot long-term anomalies or patterns that may indicate systemic issues. This historical perspective complements the month-over-month cost comparison, offering a more comprehensive view of spending trends. The tool’s design emphasizes automation, reducing the need for manual intervention in tasks such as monitoring resource utilization and generating reports. This is particularly valuable for cloud architects, DevOps engineers, and system administrators tasked with maintaining cost efficiency in dynamic AWS environments.

The motivation behind aws-doctor stems from the limitations of the AWS Console, which, while providing raw billing data, lacks contextual insights to answer critical questions about cost efficiency. elC0mpa aimed to address this gap by creating a diagnostic tool that not only highlights financial inefficiencies but also explains their implications, enabling users to make informed decisions. By automating routine checks that would otherwise require significant manual effort, the tool serves as a free, open-source solution for organizations seeking to optimize cloud spending without incurring additional costs.

Installation of aws-doctor is straightforward for users familiar with Go, as it can be installed via the `go install` command. The tool supports command-line flags to customize its behavior, such as specifying an AWS profile or region, and includes options for generating trend analyses or waste detection reports. For example, the `--trend` flag enables visualization of cost history over six months, while the `--waste` flag triggers an analysis of potential financial inefficiencies. These flags allow users to tailor the tool’s output to their specific needs, whether they are conducting a high-level audit or investigating granular resource usage patterns.

The roadmap for aws-doctor outlines future enhancements, including the ability to export reports in CSV and PDF formats, which would facilitate sharing findings with stakeholders or integrating data into other analytical workflows. Additionally, plans to distribute the tool via package managers for popular operating systems like Fedora, Ubuntu, and macOS aim to improve accessibility for a broader audience. These updates reflect the project’s commitment to scalability and user convenience, ensuring that it remains a versatile tool for cloud cost management.

The tool’s open-source nature under the MIT license encourages collaboration and customization, allowing developers to contribute improvements or adapt the tool to specific use cases. This aligns with its mission to provide a transparent, community-driven solution for AWS cost optimization. By focusing on essential features and prioritizing user-friendly design, aws-doctor bridges the gap between raw AWS billing data and actionable insights, empowering users to take control of their cloud expenditures.

Overall, aws-doctor addresses a critical need in cloud computing by offering a streamlined, automated approach to cost analysis and resource optimization. Its combination of cost comparison, waste detection, and trend visualization makes it a valuable asset for organizations looking to reduce unnecessary spending while maintaining operational efficiency. As cloud environments become increasingly complex, tools like aws-doctor play a vital role in ensuring that resources are used judiciously, ultimately contributing to more sustainable and cost-effective cloud strategies.