sudowhosudowho

Docs

Everything sudowho can do, command by command.

Setup

Install once (see the install page), then run the wizard:

sudowho init

This creates ~/.config/sudowho/config.json and walks you through your git/GitHub/Vercel profiles. You can also edit the file directly — see the config reference below.

Identity switching

Switch git, GitHub CLI, and Vercel identity for the current repo:

sudowho work

Switch and auto-generate a detailed commit message from your staged diff, then push:

sudowho work --push

Or provide your own commit message:

sudowho work -m "fix: correct pagination bug"

Other identity commands:

sudowho status
sudowho list
sudowho vercel-save work

Projects & compute

List everything you've registered, and check live Supabase status:

sudowho projects
sudowho accounts
sudowho compute-status

Wake the project you need (optionally pausing everything else marked idle-pausable), or pause everything idle:

sudowho wake my-app --pause-others
sudowho wake-all
sudowho pause my-app
sudowho pause-idle

Save a Supabase Management API token for an account (only stored locally, chmod 600):

sudowho supabase-login acme-inc sbp_xxx

Heartbeat

Supabase free-tier projects auto-pause after ~7 days of inactivity. sudowho can ping your database directly so that never happens by surprise, and tell you how many days you have left:

sudowho heartbeat
sudowho heartbeat-status

Automate it daily with a cron/LaunchAgent-style install (macOS):

sudowho heartbeat-cron-install

Git activity

See the last known push per project — branch, timestamp, days since, ahead/behind counts, and dirty state — across every account you manage:

sudowho last-push

Fetch remotes first for fresher data:

sudowho last-push --fetch

Env vault

Store and retrieve a per-project .env file, locally, chmod 600:

sudowho env-set my-app ./path/to/.env
sudowho env my-app
sudowho env-to my-app ./apps/my-app/.env

Dashboard

Prefer clicking buttons? Open the local web UI:

sudowho dashboard

It runs a tiny HTTP server bound to 127.0.0.1 only, serves a small dashboard, and wires every button to the same functions the CLI uses. Supports light and dark themes — toggle in the sidebar.

Config file

Everything lives under ~/.config/sudowho/. See the example config on GitHub for the full shape (profiles, Supabase accounts, projects, settings).