gitego

Pronounced: git-ego

Switch between multiple Git accounts in seconds. Manage SSH keys, git configs, and GitHub CLI auth per profile.

Why gitego?

Managing multiple Git accounts (work, personal, open source) usually means manually editing ~/.ssh/config, juggling git config --global, and hoping you don't push to the wrong repo with the wrong identity. gitego automates all of this:

• One command to switch — gitego use work sets your global git identity, SSH routing, and GitHub CLI auth in one shot
• Per-directory identities — bind a profile to a directory and it auto-activates when you cd into it
• SSH key isolation — each profile gets its own SSH host alias with IdentitiesOnly yes, following GitHub's official best practices
• Headless mode — every command works non-interactively for CI, scripts, and AI agents
• Automatic backups — every config change is backed up, and you can restore with gitego restore

Install

Requires Bun runtime.

bun install -g gitego

Quick Start

# Create a profile (interactive)
gitego add work

# Create a profile (headless — for CI/scripts)
gitego add work --name "John Doe" --email "john@company.com" --generate-key

# Switch global identity
gitego use work

# See who you are
gitego whoami

# List all profiles
gitego list

Commands

Command	Description
gitego add <profile>	Create a new git profile
gitego use <profile>	Switch global git identity
gitego whoami	Show active profile
gitego list	List all profile names
gitego status	Detailed view of profiles and bindings
gitego edit <profile>	Edit an existing profile
gitego rename <old> <new>	Rename a profile (preserves SSH config and bindings)
gitego remove <profile>	Delete a profile
gitego bind <profile> [path]	Bind a directory to a profile
gitego unbind [path]	Remove a directory binding
gitego clone <profile> <repo>	Clone a repo with a profile's SSH routing
gitego doctor	Check system health and profile validity
gitego restore [backup]	Restore config from a backup
gitego init <shell>	Output shell hook for auto-switching

Directory Bindings

Bind a profile to a directory so it auto-activates when you cd into it:

# Bind current directory
gitego bind work

# Bind a specific path
gitego bind personal ~/projects/side-project

# Remove a binding
gitego unbind ~/projects/side-project

Shell Integration

Add auto-switching so gitego applies the correct profile when you cd into a bound directory.

zsh — add to ~/.zshrc:

eval "$(gitego init zsh)"

bash — add to ~/.bashrc:

eval "$(gitego init bash)"

fish — add to ~/.config/fish/config.fish:

gitego init fish | source

Once configured, gitego automatically switches your local git identity when you enter a bound directory.

Headless Mode

All commands work non-interactively for scripts, CI, and AI agents:

# Add profile without prompts
gitego add work \
  --name "John Doe" \
  --email "john@company.com" \
  --ssh-key ~/.ssh/id_ed25519_work \
  --gh-username johndoe

# Generate SSH key and add it to GitHub automatically
gitego add deploy --name "Deploy" --email "deploy@ci.com" --generate-key --add-to-github

# Test SSH connection after setup
gitego add work --name "John" --email "john@work.com" --generate-key --test-ssh

# Remove without confirmation
gitego remove old-profile --yes

How It Works

• Profiles are stored in ~/.gitego/config.json
• Each profile gets an SSH host alias in ~/.ssh/config with IdentitiesOnly yes (prevents key conflicts)
• gitego use sets git config --global user.name/email, applies url.*.insteadOf rewriting (so existing clones use the correct SSH key), and optionally switches gh auth
• gitego bind sets git config --local user.name/email for per-directory identity
• gitego add --add-to-github uses gh ssh-key add to register keys programmatically
• gitego add --test-ssh verifies the SSH connection works after setup
• Automatic backups are created before every config change (max 10 retained)

Development

bun install          # install dependencies
bun test             # run tests
bun run lint         # lint with Biome
bun run typecheck    # type check
bun run check        # lint + typecheck + test (all at once)
bun run build        # compile standalone binary to dist/gitego

See CONTRIBUTING.md for more details.

License

MIT