git-switch-cli 0.1.2

Effortlessly manage multiple Git identities and SSH keys. Generate keys, save per-profile Git name/email, and switch profiles in one command. Auto-updates ~/.ssh include and your global Git config for GitHub/GitLab.

git-switch

Effortlessly manage multiple Git identities and SSH keys. Generate keys, save per-profile Git name/email, and switch profiles in one command. Auto-updates ~/.ssh include and your global Git config for GitHub/GitLab.

Usage

After installing the project in a virtual environment, run:

git-switch

You should see:

Hello from git-switch 👋

## SSH profiles utility

Manage multiple Git SSH accounts and switch keys quickly.

### Setup

```bash
git-switch ssh init

Version

Print the installed version:

git-switch --version

This creates a managed include at ~/.ssh/git-switch-managed.conf and ensures your ~/.ssh/config includes it.

Add a profile

Generate a new ed25519 key managed by this tool:

git-switch ssh add --name personal --email [e-mail] --generate

If a key already exists at the generated path, either remove it or force overwrite:

git-switch ssh add --name personal --email [e-mail] --generate --force

Or use an existing private key:

git-switch ssh add --name work --key-path ~/.ssh/id_ed25519_work --hosts github.com,gitlab.com

View the public key path printed, and add it to GitHub/GitLab.

List profiles

git-switch ssh list

Activate a profile

git-switch ssh use --name work                  # applies Git identity globally

This updates ~/.ssh/git-switch-managed.conf with the selected key for configured hosts.

Remove a profile

git-switch ssh remove --name personal
# To also delete generated keys (only if under the managed directory):
git-switch ssh remove --name personal --delete-keys --force

Profiles are stored at ~/.config/git-switch/profiles.json. Generated keys live under ~/.ssh/git-switch/<profile>/.

Store Git identity on profile

You can save Git identity per profile during add:

git-switch ssh add --name work --key-path ~/.ssh/id_ed25519_work --git-name "Your Work Name" --git-email [e-mail]

When you run ssh use, the saved Git identity is applied automatically to your global Git config.

Update a profile's Git identity

git-switch ssh update --name personal --git-name "New Name" --git-email [e-mail]

Then apply it:

git-switch ssh use --name personal

Copy a profile's public key

Copy a profile's public key to your clipboard for adding to GitHub/GitLab:

git-switch copy-key personal   # copy 'personal' profile's public key
git-switch copy-key            # copy the active profile's public key

This uses your OS clipboard tool (pbcopy on macOS, wl-copy/xclip on Linux, clip on Windows). If unavailable, the key is printed to stdout.

Development

Makefile commands

• Install: creates/uses a virtual environment and installs the package in editable mode

make install
# If a venv wasn't active, this creates .venv/. To activate:
source .venv/bin/activate

• Build: builds sdist and wheel into dist/

make build

• Test with coverage: runs the full test suite and generates terminal + HTML coverage (htmlcov/index.html)

make test

• Test an individual file or test: pass FILE to run a specific test file or node id

make test-file FILE=tests/test_cli.py
make test-file FILE=tests/test_cli.py::test_handle_copy_key_fallback_prints_key