awsd is a command-line utility that allows you to easily switch between AWS Profiles.

• Installation
  • Homebrew
  • Makefile
  • To Finish Installation
  • Upgrading
• Usage
  • Switching AWS Profiles
  • Persist Profile across new shells
  • Show your AWS Profile in your shell prompt
  • Add autocompletion
  • TL;DR (full config example)
• Contributing
• License

Make sure you have Go installed. You can download it from here.

brew tap radiusmethod/awsd
brew install awsd

make install

Add the following to your bash profile or zshrc then open new terminal or source that file

alias awsd="source _awsd"

Ex. echo 'alias awsd="source _awsd"' >> ~/.zshrc

Upgrading consists of just doing a brew update and brew upgrade.

brew update && brew upgrade radiusmethod/awsd/awsd

It is possible to shortcut the menu selection by passing the profile name you want to switch to as an argument.

> awsd work
Profile work set.

To switch between different profiles files using the menu, use the following command:

awsd

This command will display a list of available profiles files in your ~/.aws/config file or from AWS_CONFIG_FILE if you have that set. It expects for you to have named profiles in your AWS config file. Select the one you want to use.

To persist the set profile when you open new terminal windows, you can add the following to your bash profile or zshrc.

export AWS_PROFILE=$(cat ~/.awsd)

For better visibility into what your shell is set to it can be helpful to configure your prompt to show the value of the env variable AWS_PROFILE.

Here's a sample of my zsh prompt config using oh-my-zsh themes

# AWS info
local aws_info='$(aws_prof)'
function aws_prof {
  local profile="${AWS_PROFILE:=}"
  echo -n "%{$fg_bold[blue]%}aws:(%{$fg[cyan]%}${profile}%{$fg_bold[blue]%})%{$reset_color%} "
}

PROMPT='OTHER_PROMPT_STUFF $(aws_info)'

You can add autocompletion when passing config as argument by adding the following to your bash profile or zshrc file. source _awsd_autocomplete

[ "$BASH_VERSION" ] && AWSD_CMD="awsd" || AWSD_CMD="_awsd"
_awsd_completion() {
    local cur=${COMP_WORDS[COMP_CWORD]}
    local suggestions=$(awsd list)
    COMPREPLY=($(compgen -W "$suggestions" -- $cur))
    return 0
}
complete -o nospace -F _awsd_completion "${AWSD_CMD}"

Now you can do awsd my-p and hit tab and if you had a profile my-profile it would autocomplete and find it.

alias awsd="source _awsd"
source _awsd_autocomplete
export AWS_PROFILE=$(cat ~/.awsd)

If you encounter any issues or have suggestions for improvements, please open an issue or create a pull request on GitHub.

This project is licensed under the MIT License - see the LICENSE file for details.

Inspired by https://github.com/johnnyopao/awsp