# Install aws-sso-cli with Homebrew, Nix, scoop Securely manage AWS API credentials using AWS SSO. Version 2.3.1 via Homebrew; verified 2026-06-20. ## Install ```sh sudo av install brew:aws-sso-cli ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install aws-sso-cli ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#aws-sso-cli ``` Evidence: nixpkgs package indexes: pkgs/by-name/aw/aws-sso-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ### Windows - Scoop (92%): ```sh scoop install main/aws-sso-cli ``` Evidence: Scoop official bucket manifest trees: bucket/aws-sso-cli.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:aws-sso-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 2.3.1 - **Source summary:** Securely manage AWS API credentials using AWS SSO - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-only - **Source archive:** - **Last updated:** 2026-06-20T15:03:30Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - aws-sso (cli) - aws-sso (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 2.3.1 - Package-manager updated: 2026-06-20 - Local data: ok - Upstream repository: https://github.com/synfinatic/aws-sso-cli - Upstream latest detected: v2.3.1 (current) ## Project history and usage AWS SSO CLI is a Go command-line tool for AWS IAM Identity Center users who want a more ergonomic and more security-focused alternative to the stock AWS CLI SSO workflow. The project describes itself as a secure replacement for the `aws configure sso` wizard, with role selection, interactive search, profile generation, browser console helpers, and encrypted token storage. ### Project history The public repository was created in May 2021 and early GitHub releases began with v1.0.0 in July 2021. It arrived after AWS CLI v2 added native SSO support, but focused on organizations with many accounts and many IAM roles, where plain AWS CLI profiles can become cumbersome. The project evolved around two package-nerd concerns: a single static Go binary with official release artifacts, and a configuration model that could coexist with standard AWS CLI profile files. The documentation notes a move to XDG-style state under `~/.config/aws-sso` in v1.17.0 while keeping `~/.aws-sso` compatibility. ### Adoption history Homebrew carries `aws-sso-cli` in homebrew-core, and the project documentation names Homebrew as a first-class installation path. Its GitHub repository metadata showed hundreds of stars and forks in June 2026, and Homebrew analytics showed hundreds of 30-day installs, indicating use beyond a single organization without making it a default AWS tool. Adoption has tracked the AWS IAM Identity Center transition: the README explicitly notes that AWS SSO was renamed IAM Identity Center, while the underlying config fields and APIs still use SSO terminology. That made the package useful during the long period when project names, AWS docs, and API names did not all say the same thing. ### How it is used Typical use is `aws-sso` for guided setup, `aws-sso exec` or shell helpers to export short-lived STS credentials, and generated entries in `~/.aws/config` for tools that already understand AWS named profiles. The README emphasizes encrypted storage for AWS SSO client secrets, access tokens, and CLI cache credentials. The tool is most relevant for developers who switch across many AWS accounts and roles, especially when the AWS web console and CLI both need fast profile switching. ### Why package nerds care For package maintainers, AWS SSO CLI is an example of a post-AWS-CLI-v2 helper that did not just wrap `aws sso login`; it packaged a more opinionated identity workflow as one cross-platform Go binary. The Homebrew formula tracks upstream release tags, while upstream also publishes binary, RPM, and DEB artifacts. ### Timeline - 2021-05: Public GitHub repository created. - 2021-07: v1.0.0 prerelease published on GitHub. - 2021-10: v1.2.0 published as a non-prerelease GitHub release. - 2026-06: v2.3.1 published; Homebrew stable version tracked v2.3.1. ### Related projects - The README compares AWS SSO CLI to `aws-vault`, noting overlap in secure credential handling but a stronger focus on IAM Identity Center instead of long-term API keys. - `aws-sso-util` and `aws2-wrap` solve adjacent AWS SSO workflow gaps, especially profile generation, credential_process integration, or tools that lagged native SSO support. ### Sources - - - - ## Security Notes No matching local secret-handling manifest was found for aws-sso-cli. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.config/aws-sso/config.yaml, ~/.aws-sso/config.yaml, ~/.aws/config ## Credential files - Unix: ~/.aws/sso/cache/botocore-client-id-.json, ~/.aws/sso/cache/.json, ~/.aws/cli/cache/.json, ~/.aws/credentials ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** aws-sso-cli - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - aws-sso-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/aw/aws-sso-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Scoop - main/aws-sso-cli: normalized package name match | Scoop official bucket manifest trees: bucket/aws-sso-cli.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 ## Related links - [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family. - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [akamai](https://www.automicvault.com/pkg/brew/akamai/) - Shares av.db curated category or tags: api, cli, cloud-infrastructure. - [amazon-ecs-cli](https://www.automicvault.com/pkg/brew/amazon-ecs-cli/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure. - [aws-amplify](https://www.automicvault.com/pkg/brew/aws-amplify/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure. - [aws-cdk](https://www.automicvault.com/pkg/brew/aws-cdk/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure. - [aws-console](https://www.automicvault.com/pkg/brew/aws-console/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure. - [aws-elasticbeanstalk](https://www.automicvault.com/pkg/brew/aws-elasticbeanstalk/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure. - [aws-es-proxy](https://www.automicvault.com/pkg/brew/aws-es-proxy/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure. - [aws-google-auth](https://www.automicvault.com/pkg/brew/aws-google-auth/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure. - [aws-spiffe-workload-helper](https://www.automicvault.com/pkg/brew/aws-spiffe-workload-helper/) - Package names and metadata indicate a similar tool family. Shared terms: aws, cli, cloud, cloud-infrastructure, credentials. ## Combined YAML source View the package source record on GitHub. [combined/aws-sso-cli.yml](https://github.com/automic-vault/db/blob/main/combined/aws-sso-cli.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph