README
¶
whoiam is a CLI tool that prevents fat-finger deployments to the wrong AWS account — because nothing ruins your morning quite like realising you just ran terraform apply against production.
You know that sinking feeling. You get dizzy and the walls start closing in on you. Was your session pointed to dev... or prod? You know your team shouldn't have local production credentials, but hey... startups. We've all been there.
This has happened to me, and teams I have worked on more times than I care to admit. And that's why I built whoiam
A CLI tool that prevents accidental deployments to the wrong AWS account. Before running a command, it verifies that
your current credentials match the account you expect — protecting you from "fat finger" mistakes when working across multiple environments.
Features
- Run commands scoped to a specific AWS account
- Retrieve AWS IAM Role information
- Supports multiple AWS accounts
Documentation
For more information and usage examples, please refer to the documentation.
Installation
Using Homebrew
brew tap cliwright/homebrew-awstools
brew install whoiam
Download Binary
You can download the pre-compiled binaries from the releases page.
To download the pre-compiled binaries from the releases page using curl, you can use the following commands. Replace VERSION, OS, and ARCH with the appropriate values for the version, operating system, and architecture you need.
For example, to download the Linux binary for version v1.0.0:
curl -L -o whoiam_linux_x86_64.tar.gz https://github.com/cliwright/whoiam/releases/download/v1.0.0/whoiam_Linux_x86_64.tar.gz
For the Windows binary:
curl -L -o whoiam_windows_x86_64.zip https://github.com/cliwright/whoiam/releases/download/v1.0.0/whoiam_Windows_x86_64.zip
For the macOS binary:
curl -L -o whoiam_darwin_x86_64.tar.gz https://github.com/cliwright/whoiam/releases/download/v1.0.0/whoiam_Darwin_x86_64.tar.gz
Make sure to replace v1.0.0 with the actual version number you want to download.
Build from Source
git clone https://github.com/cliwright/whoiam.git
cd whoiam
go build -o whoiam
Usage
whoiam --help
Initialisation
A config file can be generated at the default location ~/.whoiam/whoiam.yaml by running the following command:
whoiam config init
Configuration
whoiam uses the AWS SDK for Go, so it will look for credentials and configuration in the default locations used by the AWS CLI and SDKs.
Contributing
Contributions are welcome! Please open an issue or submit a pull request on GitHub.
License
This project is licensed under the Apache License, Version 2.0. See the LICENSE file for details.
Author
Jesse Maitland - jesse@cliwright.com
Documentation
Source Files
Directories