[{"_1":2,"_168":-5,"_169":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_144":145},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_94":-5,"_95":96,"_135":-5,"_136":11,"_137":17,"_138":11,"_139":-5,"_140":11,"_141":-5,"_142":143},"canonicalUrl","https://hub.docker.com/r/maximleus/awscli-addons/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","maximleus","reponame","awscli-addons","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_49":50,"_52":53,"_54":55,"_56":11,"_57":58,"_59":60,"_61":62,"_39":31,"_28":29,"_64":65,"_66":51,"_67":68,"_69":70,"_71":72,"_73":-5,"_74":68,"_75":76,"_77":11,"_78":29,"_79":80,"_85":11,"_86":87,"_91":29,"_92":93},"categories",[38,43,46],{"_39":40,"_41":42},"name","Security","slug","security",{"_39":44,"_41":45},"API management","api-management",{"_39":47,"_41":48},"Developer tools","developer-tools","content_types",[51],"image","date_registered","2026-02-26T12:34:48.897796Z","description","Fast AWS CLI tools for MFA, role assumption, ECR management, and session identity.","is_private","last_updated","2026-03-16T19:01:42.112558Z","last_modified","2026-03-16T18:38:25.241321Z","media_types",[63],"application/vnd.docker.container.image.v1+json","pull_count",637,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

🚀 AWSCLI-Addons

High-performance CLI utilities to extend and simplify AWS workflows

\n\n

\n \n $\"GitHub$ \n \n \n $\"Build$ \n \n \n $\"License\"$ \n \n

\n\n

\n $\"Python\"$ \n $\"Supported$ \n

\n\n

\n A collection of high-performance, standalone CLI utilities designed to extend and simplify your daily AWS workflows. These tools bridge the gap between complex aws cli commands and common developer tasks like MFA authentication, role assumption, ECR management, and identity verification.\n

\n\n![dch-native CLI](https://raw.githubusercontent.com/MaksymLeus/awscli-addons/main/docs/images/native_cli.png)\n\n\n## 🛠️ Features\nThis suite adds specialized commands to your toolkit (with built-in shorthand aliases!):\n\n* **`whoami`** (`wi`): Quickly identifies the current IAM identity, account ID, and region.\n* **`mfa`**: Streamlines the generation of temporary session tokens using a multi-factor authentication device.\n* **`assume-role`** (`ar`): Simplifies switching between AWS accounts and IAM roles.\n* **`show-creds`** (`sc`): View your active AWS credentials (with options to export or reveal secrets).\n* **`configure`** (`conf`): Interactively configure AWS credentials and settings.\n* **`myip`**: Instantly retrieves your current public IP address (crucial for updating Security Group ingress rules).\n* **`verify`** (`ver`): Validates your current credentials and connection to ensure your environment is cloud-ready.\n* **`ecr`**: A suite of subcommands to generate Docker/Helm login commands and manage repositories.\n* **`upgrade`** (`up`): Seamlessly update the CLI to the latest version.\n\n## 📂 Project Structure\n```txt\nawscli-addons\n├── Dockerfile # Container definition for consistent environments\n├── awscli_addons/ # Main Python source package\n│ ├── cli.py # Application entry point & command routing\n│ ├── commands/ # Logic for individual CLI subcommands\n│ └── utils/ # Internal helper modules\n│ └── aws_config.py # shared logic for parsing ~/.aws files\n├── docs/ # Detailed documentation suite\n│ ├── CONFIGURATION.md # Guide for AWS profiles & aliases\n│ ├── DEPLOYMENT.md # Binary compilation & release info\n│ ├── DEVELOPMENT.md # Setup guide for contributors\n│ ├── KUBERNETES.md # Pod/CronJob & IRSA usage (Recommended)\n│ ├── OVERVIEW.md # Technical architecture deep-dive\n│ └── TODO.md # Project roadmap & pending tasks\n├── pyproject.toml # Modern Python build config & dependencies\n└── tools/ # Automation and distribution scripts\n ├── build.sh # Script to compile standalone binaries\n └── installer.sh # One-line installation & alias setup script\n```\n\n## 🚀 Installation\n\n### Instant Install (Recommended)\n\nUse our hosted installer to automatically detect your OS and Architecture.\n\n| Mode | Command |\n| :---: | --- |\n| **Auto** | `curl -sSL https://raw.githubusercontent.com/MaksymLeus/awscli-addons/main/tools/installer.sh \\| bash` |\n| **Force Binary**\t| `curl -sSL https://raw.githubusercontent.com/MaksymLeus/awscli-addons/main/tools/installer.sh \\| BINARY_CMD=true bash` | \n| **Force Python**\t| `curl -sSL https://raw.githubusercontent.com/MaksymLeus/awscli-addons/main/tools/installer.sh \\| PYTHON_ONLY=true bash` |\n\n*Prerequisites: `git` and `python 3.11+` (for Python mode).*\n\n**Install a Specific Version:**\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/MaksymLeus/awscli-addons/main/tools/installer.sh | VERSION=v1.1.2 bash\n```\n\n### Manual Installation\n\nDownload the appropriate binary for your platform from the [`Releases page`](https://github.com/MaksymLeus/awscli-addons/releases):\n\n```bash\n# Example for Linux AMD64\nwget https://github.com/MaksymLeus/awscli-addons/releases/download/${VERSION}/awscli-addons-linux-amd64\nchmod +x awscli-addons-linux-amd64\nsudo mv awscli-addons-linux-amd64 /usr/local/bin/awscli-addons\n\n```\n\n## 📖 Usage\nOnce installed, use the commands directly or via the native AWS CLI integration.\n\n### Direct Usage\n```bash\n# Check your current identity using the alias 'wi'\nawscli-addons wi\n\n# Generate MFA session for a specific profile\nawscli-addons mfa --profile default --mfa-code 123456 \n\n# View AWS credentials for the current session\nawscli-addons sc --reveal\n\n# Generate ECR Docker login command\nawscli-addons ecr login --profile my-profile\n```\n\n### Power User: Native AWS CLI Integration\nThe installer **automatically** configures an AWS CLI alias for you. If you install the official AWS CLI after these addons, the integration will be ready to use.\n\nIt adds a persistent alias to your **`~/.aws/cli/alias`** configuration, mapping **`aws addons`** directly to your `awscli-addons` binary.\n\n![dch-aliase CLI](https://raw.githubusercontent.com/MaksymLeus/awscli-addons/main/docs/images/alias_cli.png)\n\n## 🔨 Development & Building\n\nTo build the project from source or add new commands:\n\n1. Install dependencies:\n ```bash\n pip install .\n ```\n2. Add a command:\n\n\tCreate a new `.py` file in `awscli_addons/commands/` and register it in `cli.py`.\n\n3. Build standalone binaries:\n\t\n\t```bash\n\t./tools/build.sh\n\t```\n## Docker\nRun the tools inside a container:\n\n```bash\n# Interactive identity check\ndocker run --rm -v ~/.aws:/root/.aws awscli-addons whoami\n\n# Drop into a shell inside the container\ndocker run --rm -it --entrypoint bash awscli-addons\n```\n## Kubernetes \nUse the addons for debugging or automation inside your cluster.\n\n```bash\n# Bypass entrypoint to reach bash\nkubectl run aws-debug -it --rm --image=your-repo/awscli-addons:latest --command -- /bin/bash\n\n# Run identity check directly\nkubectl run aws-check --rm -it --image=your-repo/awscli-addons:latest -- wi\n```\n\n## 📚 Documentation\n\nFor more detailed information, please refer to the `docs/` directory:\n\n| Document | Purpose |\n| ------------------ | --------------------------------------- |\n| [`OVERVIEW.md`](docs/OVERVIEW.md) | Architecture and command reference. |\n| [`CONFIGURATION.md`](docs/CONFIGURATION.md) | Tool setup and AWS profile management. |\n| [`DEPLOYMENT.md`](docs/DEPLOYMENT.md) | Binary compilation and distribution. |\n| [`DEVELOPMENT.md`](docs/DEVELOPMENT.md) | Guide for contributing and building from source. |\n| [`TODO.md`](docs/TODO.md) | Roadmap & planned improvements. |\n\n## Contributing\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'feat: Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a [Pull request](https://github.com/MaksymLeus/awscli-addons/pulls)\n \nSee [`docs/DEVELOPMENT.md`](docs/DEVELOPMENT.md) for development setup.\n\n## 📄 License\nMIT License — see [`LICENSE.md`](LICENSE.md) for details.\n\n## Support\n\n- [GitHub Issues](https://github.com/MaksymLeus/awscli-addons/issues)","has_starred","hub_user","immutable_tags_settings",{"_81":11,"_82":83},"enabled","rules",[84],".*","is_automated","permissions",{"_88":17,"_89":11,"_90":11},"read","write","admin","user","storage_size",144076787,"orgData","recentTags",[97],{"_98":51,"_99":100,"_101":102,"_103":104,"_105":106,"_107":108,"_57":124,"_125":100,"_126":29,"_127":63,"_39":128,"_129":130,"_131":115,"_132":124,"_133":72,"_134":17},"content_type","creator",2328820,"digest","sha256:00d30873a04b5a1fa87452567b2051588bc17ef5cf30be76b1076d541683afa2","full_size",144066848,"id",1102766985,"images",[109],{"_110":111,"_101":102,"_112":113,"_114":115,"_116":117,"_118":119,"_120":113,"_121":-5,"_122":104,"_69":72,"_123":-5},"architecture","amd64","features","","last_pulled","2026-09-24T06:07:02.330604373Z","last_pushed","2026-03-16T19:01:36.683953927Z","os","linux","os_features","os_version","size","variant","2026-03-16T19:01:41.022873Z","last_updater","last_updater_username","media_type","latest","repository",30228020,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":146,"_156":157,"_142":166,"_167":11},{"_36":147,"_49":151,"_52":53,"_54":55,"_56":11,"_57":58,"_59":60,"_61":152,"_39":31,"_28":29,"_64":65,"_66":51,"_67":68,"_69":70,"_71":72,"_73":-5,"_74":68,"_75":76,"_77":11,"_78":29,"_79":153,"_85":11,"_86":155,"_91":29,"_92":93},[148,149,150],{"_39":40,"_41":42},{"_39":44,"_41":45},{"_39":47,"_41":48},[51],[63],{"_81":11,"_82":154},[84],{"_88":17,"_89":11,"_90":11},"tags",{"_158":70,"_159":-5,"_160":-5,"_161":162},"count","next","previous","results",[163],{"_98":51,"_99":100,"_101":102,"_103":104,"_105":106,"_107":164,"_57":124,"_125":100,"_126":29,"_127":63,"_39":128,"_129":130,"_131":115,"_132":124,"_133":72,"_134":17},[165],{"_110":111,"_101":102,"_112":113,"_114":115,"_116":117,"_118":119,"_120":113,"_121":-5,"_122":104,"_69":72,"_123":-5},[],"canDeleteTags","actionData","errors"]

maximleus/awscli-addons

Tags for maximleus/awscli-addons