Introduction

gitswitch is a terminal UI for managing multiple local git identities. Switch your name, email, SSH key, and GitHub account instantly — without touching config files.

The problem

You have multiple git accounts:

• A work account with a company email
• A personal GitHub account with your personal email
• Maybe client accounts with different SSH keys

Every time you switch repos, you need to remember to switch your git identity. Push a commit to the wrong account, and your attribution is wrong forever.

The solution

gitswitch manages everything:

gitswitch          # Interactive TUI to browse and switch profiles
gitswitch work     # Quick switch to "work" profile
gitswitch install  # Set up shell integration (prompt, nudges, completions)

One keyboard-driven tool. Instant switching. No config file edits.

Why not gh auth switch?

GitHub CLI’s gh auth switch only manages API credentials — the tokens that let gh pr create, gh issue list, etc. work.

It does not change your git commit identity (user.name and user.email).

These are independent tools solving different problems:

	gh auth switch	gitswitch
Controls	GitHub API tokens	git config user.name/email
Affects	gh CLI commands	Commit author identity
SSH key switching	No	Yes
GPG signing key	No	Yes
Works with GitLab/Bitbucket	No	Yes
Interactive TUI	No	Yes

The typical problem: You push a commit to your company repo, only to see it attributed to your personal email. gh auth switch would not have helped. gitswitch would.

Core features

• Commit identity switching — Instantly change user.name and user.email
• SSH key management — Force specific keys with IdentitiesOnly=yes
• GPG signing — Switches signing keys alongside your identity
• GitHub account sync — Optionally calls gh auth switch on profile change
• Identity awareness — Learns which identity you use per-repo, nudges you when something looks off
• Shell integration — Prompt segments, automatic nudges on cd, tab completions
• 12 color themes — Full terminal UI customization

Next steps

→ Install gitswitch
→ Quick Start Guide
→ Feature Overview