Skip to content

Quick Start

Get up and running with awsp in just a few steps.

Installation

Clone and Install

git clone https://github.com/ops4life/awsp.git
cd awsp

make install

This installs awsp into ~/.config/awsp/ and adds a source line to your shell RC file (.bashrc, .zshrc, etc.).

Reload Your Shell

After installation, reload your shell to activate awsp:

# Option 1: Restart your terminal
exec $SHELL

# Option 2: Source the script manually
. "$HOME/.config/awsp/awsp.sh"

Verify Installation

awsp --version

You should see the installed version number printed to the terminal.

First Use

List Your Profiles

Make sure you have at least one AWS profile configured:

awsp --list

If no profiles are found, configure one first:

aws configure sso

Switch to a Profile

# By name
awsp my-profile

# Or use the interactive picker
awsp

Verify Your Identity

awsp --verify my-profile

This switches to the profile and confirms your AWS identity via STS.

Uninstall

To completely remove awsp:

make uninstall

This removes all installed files and cleans up shell RC file entries.

Next Steps