awdx (AWS DevOps X) is a next-generation, human-friendly CLI tool for AWS DevSecOps. It helps you manage, automate, and secure your AWS environment with simple, interactive commands and smart suggestions.
- Profile Management: Create, switch, and validate AWS profiles interactively
- Cost Intelligence: Advanced cost analysis with anomaly detection and forecasting
- IAM Management: Comprehensive IAM security audit and compliance checking
- S3 Security: Complete S3 bucket security assessment and compliance monitoring
- Secret Management: Automated secret discovery, rotation, and compliance
- Security Assessment: Comprehensive security posture and vulnerability scanning
- Smart Suggestions: Receive actionable best-practice tips after every action
- Human-Friendly CLI: Simple, memorable commands and interactive prompts
- Future: AI/NLP-powered natural language commands
pip install .pip install awdx
๐ฆ Available on PyPI: awdx on PyPI
Show help and available commands:
awdx --help
๐ค Revolutionary AI-powered natural language interface that understands your DevSecOps intent! Chat with your AWS infrastructure using plain English. No more memorizing complex commands - just ask AWDX what you want to accomplish.
# Ask anything in natural language awdx ask "show me all my AWS profiles" ๐ค Analyzing your request... ๐ก Intent: get_current_profile ๐ฏ AWDX Command: awdx profile list โจ Alternative: aws configure list-profiles # Interactive AI chat session awdx ai chat ๐ค AWDX AI Assistant ready! Ask me anything about your AWS environment. ๐ฌ You: "What are my highest cost services this month?" ๐ค I'll help you analyze your AWS costs. Running: awdx cost summary ๐ฐ Your top 3 services: EC2 (567ใใซ.89), S3 (234ใใซ.56), RDS (123ใใซ.45) ๐ก Suggestion: Consider EC2 reserved instances to save up to 30% # Get intelligent explanations awdx ai explain "awdx iam audit --fix" ๐ง Command Breakdown: ๐ awdx iam audit: Performs comprehensive IAM security assessment ๐ง --fix flag: Automatically remediates safe issues โ ๏ธ Security Note: Review changes before applying in production ๐ฏ Best Practice: Run without --fix first to preview changes
๐ก AI Features:
โข Smart Intent Recognition - 25+ supported DevSecOps intents
โข Dual Intelligence - AWDX commands + AWS CLI alternatives
โข Security-First - Built-in security recommendations and warnings
โข Context Awareness - Understands your AWS environment and suggests workflows
โข Interactive Chat - Conversational DevSecOps automation
๐ Full Documentation: AI Engine Architecture
Manage AWS profiles with security best practices and validation.
# List all profiles awdx profile list ๐ค Found 3 profiles: ๐ฏ ๐ค default (current) ๐ค devops ๐ค prod # Switch profiles awdx profile switch devops โ To switch profile, run: export AWS_PROFILE=devops # Validate credentials awdx profile validate devops โ Profile 'devops' is valid. Account: 123456789012, ARN: arn:aws:iam::123456789012:user/devops
๐ Full Documentation: Profilyze Module README
Monitor, analyze, and optimize AWS spending with intelligent insights.
# Get cost summary awdx cost summary ๐ฐ Total Cost: 1ใใซ,234.56 ๐ Top 10 Services by Cost: 1. Amazon EC2 5ใใซ67.89 2. Amazon S3 2ใใซ34.56 3. Amazon RDS 1ใใซ23.45 # Detect anomalies awdx cost anomaly --threshold 2.5 ๐ Detecting cost anomalies for the last 30 days... ๐ Average daily cost: 1ใใซ23.45 ๐ Standard deviation: 4ใใซ5.67 โ No significant anomalies detected! # Forecast costs awdx cost forecast --months 3 ๐ฎ Forecasting costs for the next 3 months... ๐ Trend direction: Upward ๐ Monthly change: 4ใใซ5.67 ๐ฏ Trend confidence: 85.2%
๐ Full Documentation: Costlyzer Module README
Comprehensive IAM security audit, compliance checking, and smart automation.
# Security audit awdx iam audit ๐ Starting comprehensive IAM security audit... ๐ Checking root account usage... โ Using IAM user/role ๐ Checking MFA configuration... โ HIGH: 3 users without MFA ๐ Audit Summary: ๐ด Critical Issues: 0 ๐ High Issues: 1 ๐ก Medium Issues: 1 # Analyze access patterns awdx iam access ๐ Analyzing IAM access patterns... ๐ค admin (user) โก Total Permissions: 45 ๐ฏ Privileged: 12 โ Wildcards: 3 # Smart recommendations awdx iam smart --auto-fix --dry-run ๐ Generating smart IAM recommendations... 1. ๐ด Remove unused users ๐ค 2. ๐ Rotate old access keys ๐ค 3. ๐ด Review wildcard permissions ๐ค
๐ Full Documentation: IAMply Module README
Complete S3 bucket security assessment, compliance monitoring, and automated remediation.
# Comprehensive S3 audit awdx s3 audit ๐ชฃ Starting comprehensive S3 security audit... ๐ Checking bucket configurations... โ Encryption: Enabled โ HIGH: Public access detected ๐ Audit Summary: ๐ด Critical Issues: 0 ๐ High Issues: 2 ๐ก Medium Issues: 3 # Scan for vulnerabilities awdx s3 scan --type public ๐ Scanning for public S3 buckets... ๐จ Found 2 publicly accessible buckets: - my-public-bucket (HIGH RISK) - test-bucket (MEDIUM RISK) # Compliance assessment awdx s3 compliance --framework sox ๐ Assessing SOX compliance for S3... โ Encryption controls: PASS โ Access logging: FAIL โ Versioning: PASS
๐ Full Documentation: S3ntry Module README
Automated secret discovery, rotation, compliance monitoring, and smart remediation.
# Discover all secrets awdx secret discover ๐ Discovering secrets across AWS services... ๐ Found 15 secrets: - 8 in Secrets Manager - 5 in Parameter Store - 2 in IAM access keys โ HIGH: 3 secrets expired โ ๏ธ MEDIUM: 5 secrets expiring soon # Rotate secrets awdx secret rotate my-secret-id ๐ Rotating secret: my-secret-id โ Secret rotated successfully ๐ Next rotation: 2024ๅนด02ๆ15ๆฅ # Monitor secret health awdx secret monitor --days 30 ๐ Monitoring secret health for last 30 days... โ Successful rotations: 12 โ Failed rotations: 1 โ ๏ธ Expiring soon: 3
๐ Full Documentation: Secrex Module README
Comprehensive security posture assessment, vulnerability scanning, and incident response.
# Security posture assessment awdx security posture ๐ก๏ธ Starting comprehensive security posture assessment... ๐ Network Security: 85/100 ๐ IAM Security: 92/100 ๐ Data Protection: 78/100 ๐ Overall Security Score: 85/100 # Vulnerability scanning awdx security vulnerabilities --service ec2 ๐จ Scanning EC2 instances for vulnerabilities... ๐ Found 5 security issues: - 2 open security groups (HIGH) - 1 unencrypted EBS volume (MEDIUM) - 2 outdated AMIs (LOW) # Incident response awdx security incident --type breach ๐จ Initiating incident response for security breach... ๐ Investigation checklist: - CloudTrail logs analysis - IAM access review - Resource access audit - Threat detection alerts
๐ Full Documentation: SecuTide Module README
- AI-Powered Insights: Natural language queries and intelligent recommendations
- Multi-Cloud Support: Extend beyond AWS to Azure and GCP
- Integration Hub: Connect with popular DevOps tools and CI/CD pipelines
- Real-time Monitoring: Live cost and security monitoring with alerts
- Team Collaboration: Multi-user support with role-based access
- Audit Trails: Comprehensive logging and compliance reporting
- Custom Policies: Define organization-specific security and cost policies
- API Access: RESTful API for integration with existing tools
Active development with comprehensive module coverage. The project follows a modular architecture allowing for easy extension and customization.
- โ Profilyze Module: Complete with full feature set
- โ Costlyzer Module: Complete with smart analytics
- โ IAMply Module: Complete with security audit and compliance
- โ S3ntry Module: Complete with security assessment and compliance
- โ Secrex Module: Complete with secret management and rotation
- โ SecuTide Module: Complete with security posture and incident response
- ๐ง Core Infrastructure: Stable and production-ready
- ๐ Documentation: Comprehensive guides and examples
We welcome contributions! See our Contributing Guide for details on how to get started.
- ๐ Documentation: GitHub Wiki
- ๐ Issues: GitHub Issues
- ๐ฌ Discussions: GitHub Discussions
- ๐ License: MIT License
AWDX is created and maintained by Partha Sarathi Kundu (@pxkundu).
Independence Notice: AWDX is developed independently and is not affiliated with, endorsed by, or sponsored by any organization, university, or company.
- Copyright: ยฉ 2024 Partha Sarathi Kundu. All rights reserved.
- License: MIT License - see LICENSE for details
- Trademark: "AWDX" and "AWS DevOps X" are trademarks of Partha Sarathi Kundu
If you use AWDX in academic research or commercial projects, please cite:
Kundu, P. S. (2024). AWDX: AWS DevOps X - Gen AI-powered AWS DevSecOps CLI tool.
GitHub. https://github.com/pxkundu/awdx
For academic papers (BibTeX):
@software{awdx2024, author = {Kundu, Partha Sarathi}, title = {AWDX: AWS DevOps X - Gen AI-powered AWS DevSecOps CLI tool}, year = {2024}, url = {https://github.com/pxkundu/awdx}, note = {MIT License} }
- Email: inboxkundu@gmail.com
- GitHub: @pxkundu
- Project: https://github.com/pxkundu/awdx
- ๐ Troubleshooting Guide: TROUBLESHOOTING.md - Common issues and solutions
- ๐ Issues: GitHub Issues
- ๐ฌ Discussions: GitHub Discussions
See AUTHORS.md for a complete list of contributors and their contributions.