supawho

Switch between multiple Supabase accounts in seconds — on any OS.

Your access tokens live in your operating system's native secret vault, never on disk.
One command to jump between projects and clients. 🔍

Juggling multiple Supabase accounts?

Tired of the endless supabase logout → supabase login → paste token dance every time you switch project or client?

supawho saves each account once and lets you jump between them in seconds — securely, with no tokens on disk.

# 1. Install (macOS shown — Linux & Windows below)
brew install EliaTolin/tap/supawho

# 2. Use it
supawho add work sbp_your_token   # save an account (once)
supawho use work                  # switch to it in a second
supawho whoami                    # forgot which is which? map them all

Not on macOS? Grab your one-liner from Installation — install.sh for Linux, install.ps1 for Windows.

Pick your platform — every option gives you the same single, dependency-free binary.

brew install EliaTolin/tap/supawho

curl -fsSL https://raw.githubusercontent.com/EliaTolin/supawho/main/install.sh | bash

curl -fsSL https://raw.githubusercontent.com/EliaTolin/supawho/main/install.sh | bash

# Debian / Ubuntu
sudo dpkg -i supawho_*_Linux_x86_64.deb

# Fedora / RHEL
sudo rpm -i supawho_*_Linux_x86_64.rpm

# Alpine
sudo apk add --allow-untrusted supawho_*_Linux_x86_64.apk

irm https://raw.githubusercontent.com/EliaTolin/supawho/main/install.ps1 | iex

Requires Go 1.25+:

git clone https://github.com/EliaTolin/supawho.git
cd supawho
go install .

1. Open supabase.com/dashboard → profile icon (top right)
2. Account preferences → Access Tokens
3. Generate new token, name it, and copy it

💡 The token starts with sbp_ and is shown only once — copy it right away.

Then save it:

supawho add myproject sbp_xxxxxxxxxxxxx

Just run supawho with no arguments:

   ___  _   _ ___  ___  _    _ _  _  ___
  / __|| | | | _ \/ _ \| |  | | || |/ _ \
  \__ \| |_| |  _/ (_) | |/\| | __ | (_)
  |___/ \___/|_|  \__\_\__/\__|_||_|\___/

     🔍 Who are you today?

Select an account:

  1) myproject
  2) another-project

Enter number (1-2):

Got a dozen accounts and can't remember whose is whose? supawho whoami asks Supabase and maps each one to its email and organizations — a revoked token is flagged on its own row without breaking the rest:

Add a name to look up a single account: supawho whoami client-a.

The reverse lookup: paste a Supabase project ref and supawho find tells you which saved account it lives in.

$ supawho find sjslmvggunljemhwbkgm

  ✓ Found in account 'aurora'

  Project       almanaccolo
  Reference     sjslmvggunljemhwbkgm
  Organization  AuroraDigital
  Region        eu-central-1
  Status        ACTIVE_HEALTHY
  Email         mail@auroradigital.it
  Account       aurora

  Switch to it:  supawho use aurora

supawho tells you when a new version ships, and updates itself with one command:

supawho upgrade

It downloads the latest release, verifies its checksum, and swaps the binary in place. If supawho was installed through a package manager, it won't fight it — it points you to the right command instead:

Prefer silence? Set SUPAWHO_NO_UPDATE_CHECK=1 to disable the background version check.

Your tokens never touch the filesystem. They live in your operating system's native secret store — the same encrypted vault the OS uses for passwords and certificates:

• macOS → Keychain
• Linux → Secret Service (GNOME Keyring / KWallet, via libsecret)
• Windows → Credential Manager

• macOS, Linux, or Windows — a single static binary, no runtime to install
  • On Linux, a Secret Service provider must be running (GNOME Keyring, KWallet, …)
• Supabase CLI — installed and available in your PATH

Account not found when running supawho use Run supawho list to check the exact name — account names are case-sensitive.

The token stops working after switching Confirm it's still valid in Supabase Dashboard → Access Tokens, then re-add the account with a fresh one: supawho add <name> <token>.

Linux: Cannot create an item in a locked collection Your keyring is locked or no Secret Service is running. Unlock your login keyring (GNOME Keyring / KWallet) and try again.

supawho upgrade says it's managed by a package manager That's on purpose — update through the manager you installed it with (see the table above).

Issues, ideas and PRs are welcome — this project grew cross-platform thanks to the community. Special thanks to @igorgomes3 whose supawho-linux fork sparked the multi-OS rewrite.

Found a bug or want a feature? Open an issue.

MIT — Made with 💚 by Elia Tolin