gitswitch C

(noun) : SSDD for your SSDs' SDDM

what is this?

this is another port. The original python version introduced some oddities with the ssh-agent. The C implementation avoids those oddities.

Usage: gitswitch [OPTIONS] [COMMAND] [ARGS]

Commands:
  add                  Add new account interactively
  list, ls             List all configured accounts
  remove <account>     Remove specified account
  status               Show current account status
  doctor, health       Run comprehensive health check
  config               Show configuration file information
  init <shell>         Emit shell integration (fish|bash|zsh|sh)
  <account>            Switch to specified account

Options:
  --global, -g         Use global git scope
  --local, -l          Use local git scope (default)
  --dry-run, -n        Show what would be done without executing
  --verbose, -V        Enable verbose output
  --debug, -d          Enable debug logging
  --color, -c          Force color output
  --no-color, -C       Disable color output
  --help, -h           Show this help message
  --version, -v        Show version information

Examples:
  gitswitch add                    # Add new account interactively
  gitswitch list                   # List all accounts
  gitswitch 1                      # Switch to account ID 1
  gitswitch work                   # Switch to account matching 'work'
  gitswitch remove 2               # Remove account ID 2
  gitswitch doctor                 # Run health check

shell integration

gitswitch maintains a stable SSH agent socket at a fixed path so your shell can point SSH_AUTH_SOCK at it once and have every gitswitch <account> switch transparently. Add the matching line to your shell rc:

# ~/.config/fish/config.fish
gitswitch init fish | source

# ~/.bashrc
eval "$(gitswitch init bash)"

# ~/.zshrc
eval "$(gitswitch init zsh)"

The snippet guards on the socket's existence, so sourcing it before the first switch (or after /tmp has been wiped) is a silent no-op rather than an error.

Migrating from the Python gitswitch? The old gitswitch --ssh-agent-info invocation still works as a compat alias that auto-detects your shell from $SHELL, but prefer the explicit init <shell> form in new rc files.