v0.1.20 · written in go

git identity manager.
done right.

# Switch your name, email, SSH key, and GitHub account
# across profiles — instantly, without touching config files.
A keyboard-driven TUI that gets out of your way.

install now view source
view all options →
$
brew install aksisonline/tap/gitswitch
gitswitch — identity manager
click to focus · ↑↓ nav · ↵ switch · a add · c theme · ? help
theme · Nord
12
color themes
∞
git profiles
5
fields per profile
MIT
open source
capabilities

everything gh auth switch
can't do.

# GitHub CLI only manages API tokens. Your commit identity — the name and email baked into every commit — is completely separate. gitswitch handles both.

[01]
commit identity switching
Instantly change user.name and user.email in your global git config. No more wrong-email commits.
[02]
ssh key management
Sets core.sshCommand to force a specific key with IdentitiesOnly=yes, preventing agent fallback.
[03]
gpg signing keys
Switches user.signingkey alongside your identity so signed commits always use the right key.
[04]
github account sync
Optionally calls gh auth switch on profile change. Best-effort — your git config always switches even if gh fails.
[05]
identity awareness
Learns which identity you use per-repo. Nudges you when something looks off. Pin a permanent identity with gitswitch pin.
[06]
shell integration
One command sets up your prompt segment, identity nudges on cd, and tab completions. Works with Starship, p10k, oh-my-zsh.
comparison

vs gh auth switch

# Two tools, two different problems. gitswitch handles what the GitHub CLI intentionally ignores.

capability gh auth switch gitswitch
github api tokens ✓ ✓ (optional)
git config user.name/email ✗ ✓
ssh key switching ✗ ✓
gpg signing key ✗ ✓
shell prompt integration ✗ ✓
interactive tui ✗ ✓
repo-specific identity pinning ✗ ✓
install

up in 30 seconds.

# Choose your preferred installation method. Homebrew is recommended for automatic updates.

homebrew — recommended

brew install aksisonline/tap/gitswitch
auto-updates with brew upgrade

curl — one-liner

curl -fsSL https://raw.githubusercontent.com/aksisonline/gitswitch/main/.github/install.sh | bash
works on macOS and Linux

build from source

git clone https://github.com/aksisonline/gitswitch
cd gitswitch && make install
requires go 1.21+
~/projects/myapp
❯ gitswitch
# Opens the TUI — first run auto-imports your current git config
❯ gitswitch work
✓ Switched to work
user.name → Alice Smith
user.email → alice@company.com
SSH key → ~/.ssh/id_work
❯ gitswitch add oss "Alice" alice@oss.dev --ssh-key ~/.ssh/id_oss --gh-user alice-oss
✓ Profile 'oss' added
❯ gitswitch install
Detected: Starship
✓ Prompt segment configured
✓ Tab completion enabled
✓ Identity nudge active
Reload: source ~/.zshrc
❯ gitswitch pin work
✓ Pinned 'work' to this repo
looking ahead

v2 & v3 roadmap

Coming features for teams & multi-org workflows

v2 · per-project control
Per-directory git identity
Switch identities per project folder. Freelancers can work on multiple client codebases in parallel — each repo uses its own git account, email, and SSH key.
Git setup diagnostic
Auto-detect & fix common issues: missing gh_user on profile, empty ~/.gitconfig, missing gh credential helper, stale SSH keys. One command to verify & heal.
In development · informed by real-world setup failures.
v3 · multi-org support
GitLab & Bitbucket
Manage identities across GitHub, GitLab, and Bitbucket in one tool. Switch all platforms at once or per-project.
Planned · builds on v2 architecture.