Skip to content

AWS Cloud Utilities v2

A unified command-line toolkit for AWS operations with enhanced functionality. This package consolidates various AWS management scripts into a single, powerful CLI tool.

✨ Features

  • 🎯 Unified CLI: Single command interface for all AWS operations
  • ⚡ Parallel Processing: Multi-threaded operations for improved performance
  • 🎨 Rich Output: Beautiful, formatted output with tables and colors
  • ⚙️ Flexible Configuration: Support for AWS profiles, regions, and custom settings
  • 📊 Comprehensive Coverage: Tools for cost optimization, inventory, security, logs, and more
  • 🔒 Security First: Built-in security auditing and best practices
  • 📈 Cost Optimization: Advanced cost analysis and optimization tools

🚀 Quick Start

# Install from PyPI (when published)
pip install aws-cloud-utilities

# Install from source
git clone https://github.com/jon-the-dev/aws-cloud-tools.git
cd aws-cloud-tools/v2
pip install -e .

Basic Usage

# Confirm which account you are pointed at
aws-cloud-utilities account info

# Scan every resource in every region
aws-cloud-utilities inventory scan --output-dir ./inventory

# Find EBS volumes worth changing
aws-cloud-utilities costops ebs-optimization --all-regions --include-cost-estimates

# Collect spot pricing data
aws-cloud-utilities costops spot-pricing --all-regions --output-dir ./spot-data

# Download the last 7 days of a log group
aws-cloud-utilities logs download /aws/lambda/my-function

# Security findings from WAF, GuardDuty, and Security Hub
aws-cloud-utilities security metrics

🏗️ Command Structure

The CLI follows a hierarchical structure similar to the AWS CLI:

aws-cloud-utilities [GLOBAL-OPTIONS] <service> <operation> [OPTIONS]

Available Services

Click any command name for its full documentation, options, and examples.

Command Description Subcommands
account Account information and management commands. contact-info, detect-control-tower, info, limits, regions, service-regions, validate
awsconfig AWS Config service management and compliance monitoring commands. compliance-checker, compliance-status, download, list-rules, show-rules
bedrock Amazon Bedrock management commands. list-custom-models, list-model-jobs, list-models, model-details, regions
billing AWS billing and Cost and Usage Report (CUR) management commands. cur-create, cur-delete, cur-details, cur-list, cur-setup, cur-validate-bucket
cloudformation AWS CloudFormation management and backup commands. backup, list-stacks, stack-details
cloudfront AWS CloudFront distribution management and monitoring commands. distribution-details, invalidate, list-distributions, update-logging
configure Configure AWS Cloud Utilities settings. (none)
costops AWS cost optimization and analysis commands. cost-analysis, ebs-optimization, pricing, spot-analysis, spot-pricing, usage-metrics
dynamodb DynamoDB cost and capacity analysis commands. cost-analysis
ecr AWS ECR (Elastic Container Registry) management commands. copy-image, create-repository, delete-repository, get-login, list-images, list-repositories
iam IAM management and auditing commands. audit, list-policies, list-roles, policy-details, role-details
info Show AWS Cloud Utilities information. (none)
inventory AWS resource inventory and discovery commands. download-all, scan, services, workspaces
logs AWS CloudWatch Logs management and processing commands. aggregate, combine, delete-group, download, list-groups, set-retention
networking AWS networking and IP management commands. ip-ranges, ip-summary
rds RDS management and troubleshooting commands. list-instances, troubleshoot-mysql
s3 AWS S3 bucket and object management commands. analyze-encryption, bucket-details, create-bucket, delete-versions, download, list-buckets, nuke-bucket, restore-objects
security AWS security monitoring and certificate management commands. create-certificate, list-certificates, metrics
stepfunctions AWS Step Functions management and monitoring commands. describe, execute, list, list-executions, logs
support AWS support tools commands. cases, check-level, services, severity-levels, trusted-advisor
waf AWS WAF management and troubleshooting commands. list, stats, troubleshoot

Global Options

  • --profile: AWS profile to use
  • --region: AWS region
  • --output: Output format (table, json, yaml, csv)
  • --verbose: Enable verbose output
  • --debug: Enable debug mode
  • --config: Configuration file path

Global options go before the command name. See the CLI Reference for the full list.

🎯 Key Improvements from v1

Enhanced User Experience

  • Rich Console Output: Beautiful tables, colors, and progress indicators
  • Multiple Output Formats: JSON, YAML, table, and CSV support
  • Better Error Handling: Clear error messages with actionable guidance
  • Unified Interface: Single command instead of multiple scripts

Performance & Reliability

  • Parallel Processing: Multi-threaded operations with configurable workers
  • Graceful Degradation: Works with limited permissions
  • Robust Error Handling: Proper exception handling and recovery
  • Modern Python: Type hints, proper packaging, comprehensive testing

Advanced Features

  • Configuration Management: Environment variables and config file support
  • Flexible Authentication: Multiple AWS profile and region support
  • Extensible Architecture: Plugin-ready design for future enhancements
  • Comprehensive Testing: Unit tests, integration tests, and CI/CD

📚 Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details on:

  • Setting up the development environment
  • Running tests
  • Code style guidelines
  • Submitting pull requests

📄 License

MIT License - see LICENSE file for details.

🆘 Support

AWS Cloud Utilities v2 - Making AWS management simple, powerful, and efficient.