Skip to content
Bash based AWS read-only client to make the AWS Console less necessary
Shell Makefile Python
Branch: master
Clone or download
Pull request Compare This branch is 209 commits behind theserverlessway:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


│                 ___   ____    __    ____   _______. __  .__   __.  _______   ______              │
│                /   \  \   \  /  \  /   /  /       ||  | |  \ |  | |   ____| /  __  \             │
│               /  ^  \  \   \/    \/   /  |   (----`|  | |   \|  | |  |__   |  |  |  |
│              /  /_\  \  \            /    \   \    |  | |  . `  | |   __|  |  |  |  |            │
│             /  _____  \  \    /\    / .----)   |   |  | |  |\   | |  |     |  `--'  |            │
│            /__/     \__\  \__/  \__/  |_______/    |__| |__| \__| |__|      \______/             │
│                                                                                                  │

awsinfo is a read-only client for AWS written in Bash. It tries to replace the AWS console for getting basic information about your AWS resoures in your CLI. No more opening the AWS Console when all you want to know is basic information about your resources.

Why a read-only AWS Client

When we try to get the most out of AWS by building on top of as many AWS services as possible we regularly have to look up information about our resources. From checking the deploment status of a CloudFormation stack to the number of messages in an SQS Queue, the status of a CodeBuild Project or the number of EC2 instances currently running.

Looking up this information often requires us to go through the AWS Console as the CLI tooling that AWS provides is a great interface to their API, but hard to use for getting an overview on deployed resources quickly. awsinfo provides you with default views, similar to the AWS Console, for various (and growing) AWS services so you can get the most important information. While awsinfo provides you with some access to deeper information on specific services, for the most part once you want to dig really deep other tools like the awscli or aws-shell are great for exploring all the details.

Why Bash

Terminals are the most common piece of tech we all use, regardless of the specific language we prefer. By building awsinfo as a collection of bash scripts you can easily see and understand how it works under the hood. If it doesn't do exactly what you need it to do you can copy the script, edit it to do exactly what you need and add that to your repository or local bash.

This is much more complicated if this tool were built on any specific programming language as we'd have to understand a lot more of the environment to get it up and running.

Building it with Bash also means we can use the awscli directly which removes a lot of necessary implementation.


While you can simply clone the repository and run the awsinfo.bash file directly (e.g. by putting it into your PATH) the preferred method of installation is going through Docker. This allows tight control over everything that is used in awsinfo (e.g. Bash Version or other tools that need to be available like gnu time) while making it easy for you to install and use. In case you install awsinfo by cloning the repo make sure you have Bash 4 and the awscli installed. Some commands might need specific cli tools as well, check the Dockerfile for all the tools that are installed.

Using Docker directly

You can use the following command to use the awsinfo Docker container with pure Docker. It will automatically download it and run the container for you with any Arguments you append at the end. It makes the ~/.aws folder accessible as a Volume as well as forwarding all awscli default environment variables.


You can set it up as an alias in your shell config file as well.

alias awsinfo='docker run -it -v ~/.aws:/root/.aws -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -e AWS_SESSION_TOKEN -e AWS_DEFAULT_REGION -e AWS_DEFAULT_PROFILE -e AWS_CONFIG_FILE flomotlik/awsinfo'


If you're using Whalebrew(Which I highly recommend you doing) simply run the following to install:

whalebrew install flomotlik/awsinfo


To update the Docker container run docker pull flomotlik/awsinfo:latest


awsinfo commands support commands and subcommands, for example you can run awsinfo logs to print log messages or awsinfo logs groups to get a list of all log groups in the current account and region.

To see all available commands check out the following list or run awsinfo commands.

You can run any command with --help (e.g. awsinfo logs --help) to see the same help page that is in the repo (and linked below).

Available Commands

You can’t perform that action at this time.