Provider Connections
Set up GitHub and Linear tokens using encrypted storage, env vars, or shell commands.
git-switchboard integrates with external services via providers.
Run git-switchboard connect to view and manage your
connections.
Provider List
The provider list shows all available integrations with their current
connection status. A green ✓ means the token is configured;
a red ✗ means it is not.
Press Enter on a provider to view its details or set up a new token.
Supported Providers
| Provider | Used For | Env Variables |
|---|---|---|
| GitHub | Fetching PRs, CI status, reviews, retrying checks | GH_TOKEN, GITHUB_TOKEN |
| Linear | Linking Linear issues to branches and PRs | LINEAR_TOKEN |
Provider Detail
The detail view shows the connection status, authenticated identity, and a link to the provider's token settings page. If the token was stored via git-switchboard (rather than an environment variable), you can press d to disconnect it.
Setting Up a Token
Press s from the provider detail view (or select a provider
when running git-switchboard connect <provider>) to
start the setup flow. You'll choose a storage strategy:
Storage Strategies
| Strategy | Description |
|---|---|
| Environment variable | Reads the token from an env var you specify (e.g.
GH_TOKEN). The variable must be set in your
shell profile. git-switchboard validates it on setup and reads
it at each launch. |
| Encrypted (machine-locked) | The token is encrypted and stored in
~/.config/git-switchboard/. Decryption is tied to
your machine — no password needed, but the file can't be
copied to another computer. |
| Encrypted (password-protected) | Like machine-locked, but also requires a password you choose. You'll be prompted for the password each time git-switchboard launches. |
| Shell command | Runs a shell command each launch to fetch the token. Useful
for integrations with secret managers like 1password,
vault, or pass. |
Token Resolution Order
When git-switchboard needs a token, it checks sources in this order:
- CLI flag (e.g.
--github-token) - Configured strategy in
~/.config/git-switchboard/config.json - Environment variables (e.g.
GH_TOKEN,GITHUB_TOKEN) - Fallback command (GitHub only:
gh auth token)
The first source that provides a non-empty value wins. Run
git-switchboard connect and select a provider to see which
source is currently active.