Skip to main content

aws-sso-switcher

Switch between AWS SSO profiles with one command. No shell setup required.

Install

pipx install aws-sso-switcher

Requires AWS CLI v2.

Configure

Define profiles in ~/.aws/config, named however you like:

[sso-session my-org]
sso_start_url = https://my-org.awsapps.com/start
sso_region = us-east-1
sso_registration_scopes = sso:account:access

[profile dev]
sso_session = my-org
sso_account_id = 111111111111
sso_role_name = AdministratorAccess
region = us-east-1

Use

awsp dev        # make 'dev' the default profile, SSO login if needed
awsp            # interactive picker
awsp -l         # list profiles
aws s3 ls       # now runs against 'dev'

awsp copies the selected profile into [default] in ~/.aws/config (a backup is saved to ~/.aws/config.bak). The switch applies to all terminals.

If AWS_PROFILE is set in your shell it overrides the default; unset AWS_PROFILE.

Per-terminal mode (optional): eval "$(awsp --export-env dev)"

Metadata

Release files for aws-sso-switcher 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aws-sso-switcher 1.0.0
File Size Uploaded
aws_sso_switcher-1.0.0.tar.gz 4.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for aws-sso-switcher 1.0.0
File Interpreter ABI Platform
aws_sso_switcher-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 9.4 kB

Release files / aws_sso_switcher-1.0.0.tar.gz

Download URL aws_sso_switcher-1.0.0.tar.gz
Size 4.2 kB
Tags Source
SHA-256 checksum
How to use checksums
083e0b8920a386c4db7f31e2af522ab2d003ce1bd99fad530e26745cfda5abb1
BLAKE2b-256 checksum
How to use checksums
f6c05605607886f20545b3da9fd26b503685d7d7ecc93612fb2de806fa0b038e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / aws_sso_switcher-1.0.0-py3-none-any.whl

Download URL aws_sso_switcher-1.0.0-py3-none-any.whl
Size 5.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a5edb067270770fdb61f2c0853fb14187874baa190dff53950e1001e64a0aaea
BLAKE2b-256 checksum
How to use checksums
dd270cecfc0ac71e978dc51ed131435cdfa78da806439890a50ff1aa35cf83b3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page