git-user-switch

zsh-plugin-git-user-switch is a Z shell plugin that enables developers to seamlessly switch between different GitHub identities across repositories. It ensures safe and predictable identity management by coordinating git configuration, SSH routing, and optional GitHub CLI authentication without hidden global changes.

Key Features

• Safe Mode — Uses per-user SSH host aliases (e.g., github-work) to rewrite repository remotes, avoiding modifications to the global SSH configuration.
• Magic Mode — Opt-in mode that atomically rewrites the global Host github.com block in SSH config with timestamped backups.
• GitHub CLI Integration — Automatically switches gh authentication to match the selected user when enabled.
• Auto-Switching — Detects repository-local git user email on directory changes and applies the appropriate identity silently.
• State Inspection — Provides gus status and gus doctor commands to inspect current configuration and diagnose issues.
• Configuration Management — Uses a single GUS_USERS associative array as the source of truth for user identities, SSH keys, and host aliases.

Philosophy

The plugin prioritizes safe, deterministic, and repository-scoped behavior by default, ensuring no hidden writes to SSH config and making all state easily inspectable. An optional magic mode is available for users who prefer global SSH rewrites with explicit backups.