{"id":42674479,"url":"https://github.com/elc0mpa/aws-doctor","last_synced_at":"2026-04-30T07:05:07.159Z","repository":{"id":312445406,"uuid":"1047497737","full_name":"elC0mpa/aws-doctor","owner":"elC0mpa","description":"Diagnose AWS costs, detect idle resources, and optimize cloud spending directly from your terminal. 🩺 ☁️","archived":false,"fork":false,"pushed_at":"2026-02-01T19:10:16.000Z","size":18562,"stargazers_count":277,"open_issues_count":3,"forks_count":11,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-02-02T01:34:56.693Z","etag":null,"topics":["aws","aws-billing","aws-cli","aws-cost-explorer","aws-doctor","aws-trusted-advisor","cli","go","golang"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/elC0mpa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-08-30T14:57:45.000Z","updated_at":"2026-02-01T19:08:54.000Z","dependencies_parsed_at":"2025-08-30T18:33:36.654Z","dependency_job_id":null,"html_url":"https://github.com/elC0mpa/aws-doctor","commit_stats":null,"previous_names":["elc0mpa/aws-cost-billing","elc0mpa/aws-doctor"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/elC0mpa/aws-doctor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elC0mpa%2Faws-doctor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elC0mpa%2Faws-doctor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elC0mpa%2Faws-doctor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elC0mpa%2Faws-doctor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elC0mpa","download_url":"https://codeload.github.com/elC0mpa/aws-doctor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elC0mpa%2Faws-doctor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29179560,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T22:12:24.066Z","status":"ssl_error","status_checked_at":"2026-02-06T22:12:09.859Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","aws-billing","aws-cli","aws-cost-explorer","aws-doctor","aws-trusted-advisor","cli","go","golang"],"created_at":"2026-01-29T11:26:15.880Z","updated_at":"2026-04-30T07:05:07.150Z","avatar_url":"https://github.com/elC0mpa.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# aws-doctor\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://awsdoctor.compacompila.com/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Documentation-Website-blue?style=for-the-badge\u0026logo=hugo\" alt=\"Website\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/avelino/awesome-go\"\u003e\u003cimg src=\"https://awesome.re/mentioned-badge.svg\" alt=\"awesome-go\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/elC0mpa/aws-doctor/blob/main/go.mod\"\u003e\u003cimg src=\"https://img.shields.io/github/go-mod/go-version/elC0mpa/aws-doctor\" alt=\"Go Version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://pkg.go.dev/github.com/elC0mpa/aws-doctor\"\u003e\u003cimg src=\"https://pkg.go.dev/badge/github.com/elC0mpa/aws-doctor.svg\" alt=\"Go Reference\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://goreportcard.com/report/github.com/elC0mpa/aws-doctor\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/elC0mpa/aws-doctor\" alt=\"Go Report Card\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://codecov.io/gh/elC0mpa/aws-doctor\"\u003e\u003cimg src=\"https://codecov.io/gh/elC0mpa/aws-doctor/graph/badge.svg\" alt=\"codecov\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/elC0mpa/aws-doctor/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/elC0mpa/aws-doctor/total?color=blue\u0026label=Downloads\" alt=\"GitHub all releases\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/elC0mpa/aws-doctor/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/elC0mpa/aws-doctor/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/elC0mpa/aws-doctor/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/elC0mpa/aws-doctor\" alt=\"License\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nA 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.\n\n\u003e [!TIP]\n\u003e **View the full documentation, permissions guide, and usage examples at [awsdoctor.compacompila.com](https://awsdoctor.compacompila.com/)**\n\n## 👀 Quick glance\n\n### ⚖️ Comparative Cost Analytics\n![Comparative Cost Analytics](https://github.com/elC0mpa/aws-doctor/blob/main/docs/static/images/demo/basic.gif?raw=true)\n\n### 📈 6-Month Trend Analysis\n![6-Month Trend Analysis](https://github.com/elC0mpa/aws-doctor/blob/main/docs/static/images/demo/trend.gif?raw=true)\n\n### 🧟 Waste Detection\n![Waste Detection](https://github.com/elC0mpa/aws-doctor/blob/main/docs/static/images/demo/waste.gif?raw=true)\n\n*Supports selective scanning: `aws-doctor waste ec2 s3 cloudwatch rds vpc lambda sagemaker elb ecr`*\n\n## 📄 Professional Reporting\n\n`aws-doctor` can now generate detailed, professional PDF reports ready for stakeholders. Reports include branded headers, styled tables, and comprehensive cost/waste analyses.\n\n\u003e [!TIP]\n\u003e **View PDF reporting examples and details at [awsdoctor.compacompila.com/docs/reporting/](https://awsdoctor.compacompila.com/docs/reporting/)**\n\n### Generate a Cost Comparison Report\n```bash\naws-doctor report cost\n```\n\n### Generate a Waste Analysis Report\n```bash\n# Full waste report\naws-doctor report waste\n\n# Selective checks (e.g., ec2, s3, and lambda only)\naws-doctor report waste ec2 s3 lambda sagemaker\n```\n\n### Generate a Trend Report\n```bash\n# Full trend report (all services)\naws-doctor report trend\n\n# Selective services (e.g., ec2 and rds only)\naws-doctor report trend ec2 rds\n```\n\n\u003e [!TIP]\n\u003e **Subcommand Arguments:** Just like the terminal commands, `report waste` accepts specific checks (e.g., `ec2`, `s3`, `rds`, `lambda`) and `report trend` accepts specific service names.\n\n\u003e [!TIP]\n\u003e By default, reports are saved in your **Documents** folder. Use the `--path` flag to specify a custom directory or filename:\n\u003e `aws-doctor report cost --path ./billing-analysis.pdf`\n\n## 🚀 Installation\n\n**Homebrew (macOS/Linux):**\n\n```bash\nbrew install elC0mpa/homebrew-tap/aws-doctor\n```\n\n**One-Line Script (macOS/Linux):**\n\n```bash\ncurl -sSfL https://raw.githubusercontent.com/elC0mpa/aws-doctor/main/install.sh | sh\n```\n\n**Windows (PowerShell):**\n\n```powershell\nirm https://raw.githubusercontent.com/elC0mpa/aws-doctor/main/install.ps1 | iex\n```\n\n**Using Go:**\n\n```bash\ngo install github.com/elC0mpa/aws-doctor@latest\n```\n\n## ✨ Key Features\n\n- **📄 Professional PDF Reports:** Generate branded, ready-to-share PDF documents for costs, trends, and waste analysis.\n- **📉 Fair Cost Comparison:** Compares identical time windows between months to spot real anomalies.\n- **🧟 Zombie Discovery:** Scans for idle EIPs, stopped instances, orphaned snapshots, idle RDS instances, idle NAT Gateways, idle Load Balancers, over-provisioned Lambda memory, idle SageMaker real-time inference endpoints, and ECR repositories with untagged images, missing lifecycle policies, or no images at all. Supports selective service filtering (`ec2`, `s3`, `elb`, `cloudwatch`, `rds`, `vpc`, `lambda`, `sagemaker`, `ecr`).\n- **📊 6-Month Trends:** High-fidelity ANSI visualization of your spending velocity.\n- **📤 Multiple Output Formats:** Export results in `table`, `json`, or `csv` for easy integration with other tools or reporting.\n- **🔔 Update Notifications:** Automatically checks for new versions in the background and notifies you after command output, so you never miss an update.\n- **🔐 MFA Ready:** Native support for profiles requiring Multi-Factor Authentication.\n- **🌍 Region-Aware Pricing:** Queries the AWS Pricing API at startup to use rates for the configured region, falling back to us-east-1 defaults if the API is unavailable. Requires `pricing:GetProducts` in the caller's IAM policy; without it, estimates silently fall back to defaults.\n\n## 💡 Motivation\n\nAs 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?\"_*\n\nI 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.\n\n## 👥 Community\n\n### Contributors\n\nA huge thank you to everyone who has contributed to **aws-doctor**! Your help makes this tool better for everyone.\n\n\u003ca href=\"https://github.com/elC0mpa/aws-doctor/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=elC0mpa/aws-doctor\" alt=\"Contributors\" /\u003e\n\u003c/a\u003e\n\n### Star History\n\n\u003ca href=\"https://www.star-history.com/?type=date\u0026legend=top-left\u0026repos=elC0mpa%2Faws-doctor\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/chart?repos=elC0mpa/aws-doctor\u0026type=date\u0026theme=dark\u0026legend=top-left\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/chart?repos=elC0mpa/aws-doctor\u0026type=date\u0026legend=top-left\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/chart?repos=elC0mpa/aws-doctor\u0026type=date\u0026legend=top-left\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n## 🤝 Contributing\n\nWe love contributions! Whether it's a new detection rule or a bug fix, check our [Community Dashboard](https://awsdoctor.compacompila.com/#join-the-community) to get started.\n\n\u003e [!IMPORTANT]\n\u003e **Always target your Pull Requests to the `development` branch.** The `main` branch is reserved for production-ready releases. Check our [Contributing Guidelines](CONTRIBUTING.md) for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felc0mpa%2Faws-doctor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felc0mpa%2Faws-doctor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felc0mpa%2Faws-doctor/lists"}