Skip to content

awsp — AWS Profile Switcher

awsp logo

awsp is a lightweight, cross-shell AWS profile switcher with SSO auto-login support. It's implemented as a pure POSIX shell function and works in both Bash and Zsh without external dependencies like fzf.

Key Features

  • Cross-shell support — Works in both Bash and Zsh
  • Zero dependencies — No fzf or other external tools required
  • Interactive picker — Numbered profile selection when no argument is passed
  • SSO auto-login — Automatically authenticates when credentials expire
  • Profile persistence — Remembers your last selected profile across sessions
  • Tab completion — Dynamic completion for both shells
  • Self-upgrade — Built-in upgrade command

Quick Example

# Switch to a profile by name
awsp my-profile

# Or pick from an interactive list
awsp
# Pick an AWS profile:
#  1) dev-account
#  2) staging-account
#  3) prod-account
# Select number: 2

Requirements

  • Bash or Zsh shell
  • AWS CLI v2 (recommended for SSO features, optional for basic profile switching)
  • At least one AWS profile configured

Getting Started

Ready to get started? Head over to the Quick Start guide to install and configure awsp in under a minute.