$ show mbailey/bash-my-aws
Bash-my-AWS is a CLI toolset designed to manage AWS resources using Bash functions and aliases. It wraps the AWS CLI with convenience functions for listing, filtering, and manipulating resources like EC2, S3, and CloudFormation. The architecture is a monolithic Bash library sourced into the user's shell environment, with modularized logic in `lib/*-functions`. It relies heavily on `awscli`, `jq`, and standard Unix utilities. The tool implements a pipe-skimming pattern (`skim-stdin`) that allows chaining commands (e.g., `instances | instance-stop`), enhancing usability for shell scripting. It includes a Python-based caching proxy (`bin/cachews`) to reduce API latency. While well-structured for Bash, it carries inherent risks due to the language's limitations, including security vulnerabilities in SSH handling and reliance on `eval` for argument inference. The repository is actively maintained with recent commits and a comprehensive test suite using a custom BDD-style framework. However, technical drift is moderate due to the rapid evolution of AWS APIs and Bash-specific security concerns. The codebase is suitable for engineers comfortable with Bash scripting who need a robust set of AWS management utilities.
The LLM identified 3 files worth highlighting for reuse:
Implements the `skim-stdin` pattern, which appends the first token from each line of STDIN to command arguments. This enables powerful chaining of AWS commands (e.g., `instances | instance-stop`). It is a self-contained, reusable pattern that demonstrates non-obvious Bash skill in handling STDIN parsing and argument manipulation.
A Python script that acts as a zero-config caching proxy for `awscli`. It intercepts CLI output and caches responses based on request parameters to reduce latency. This is a reusable component for API latency reduction that could be extracted for other CLI tools.
Generates `aliases`, `functions`, and `bash_completion.sh` from the source library files. This automated code generation ensures consistency between source and output, preventing drift. It demonstrates a robust build pipeline for Bash projects.