Skip to content
supawhosupawho

Getting started

supawho is a single, dependency-free binary. Pick your platform — every option installs the same tool.

Install

Section titled “Install”

macOS

Section titled “macOS”
Terminal window
brew install EliaTolin/tap/supawho

Or with the install script:

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

Linux

Section titled “Linux”
Terminal window
curl -fsSL https://raw.githubusercontent.com/EliaTolin/supawho/main/install.sh | bash

Or grab a native package (.deb / .rpm / .apk) from the releases page and install it with your package manager.

Windows

Section titled “Windows”
Terminal window
irm https://raw.githubusercontent.com/EliaTolin/supawho/main/install.ps1 | iex

Or download supawho_*_Windows_x86_64.zip from the releases page, extract supawho.exe, and add it to your PATH.

From source

Section titled “From source”

Requires Go 1.25+:

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

Get your Supabase access token

Section titled “Get your Supabase access token”
  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.

Save and switch

Section titled “Save and switch”
Terminal window
supawho add work sbp_your_token   # save an account (once)
supawho use work                  # switch to it in a second

Run supawho with no arguments for an interactive picker, or head to the Commands page for the full reference.