Easily switch between AWS Profiles.

Expanded fork of awsp by johnnyopao with additional features and ongoing maintenance.*

* no guarantee expressed or implied.

The AWS CLI will use the profile present in the AWS_PROFILE environment variable, if no flag is set. This script parses the current aws profiles (~/.aws/config) and provides a filterable list, and then sets that environment variable based on your selection.

Set up any number of profiles using the aws cli.

aws configure --profile PROFILE_NAME

You can also leave out the --profile PROFILE_NAME param to set your default credentials

Refer to the AWS CLI Documentation for more information: https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html

npm install -g awsp-plus

Add the following line to your .bashrc or .zshrc config:

alias awsp="source _awspp"

An alias is used because _awspp needs to be sourced to be able to modify the calling shell's environment variables.

Standard usage is just to call awsp and select a profile:

awsp

You can type to filter the list, or arrow through the shown options. Press <Enter> to select the highlighted option.

You can also type a profile with the command to immediately switch:

awsp development

This is equivalent to export AWS_PROFILE='development'.

For better visibility into which AWS Profile is selected it's helpful to configure your prompt to show the value of the env variable AWS_PROFILE.

Here is a simplified example:

function aws_prof {
  local profile="${AWS_PROFILE:=default}"

  echo "aws:(${profile})"
}

PS1="$PS1 \$(aws_prof)"

Here's @johnnyopao's example using oh-my-zsh themes, with nice colors:

function aws_prof {
  local profile="${AWS_PROFILE:=default}"

  echo "%{$fg_bold[blue]%}aws:(%{$fg[yellow]%}${profile}%{$fg_bold[blue]%})%{$reset_color%} "
}

PROMPT='OTHER_PROMPT_STUFF $(aws_prof)'

A more advanced example for bash can be found in my dotfiles at https://github.com/abyss/dotfiles.

Issues and pull requests are welcome. 😄

This project and the original work are licensed under the ISC License.

Copyright (c) 2021 Abyss

Original Work Copyright (c) 2020 Johnny Opao (@ https://github.com/johnnyopao/awsp)