Git ID Switcher 🖖

Qapla'! tlhIngan Hol jatlhlaH'a'? DaH Git ID choHlaH!

(Success! Can you speak Klingon? Now you can switch Git ID!)

wa' weQ neH Git profiles law' DachoH. GitHub accounts law', SSH keys, GPG signing Daqon, Git Submodules profiles automatic apply.

🇺🇸 🇯🇵 🇨🇳 🇹🇼 🇰🇷 🇩🇪 🇫🇷 🇪🇸 🇧🇷 🇮🇹 🇷🇺 🇵🇱 🇹🇷 🇨🇿 🇭🇺 🇧🇬 🇺🇦 🌍 🌺 🐻 🐉 ✨ 🖖 🐱 🏴‍☠️ 🎭

🎯 qatlh Git ID Switcher?

Git profile switchers law' tu'lu', 'ach Git ID Switcher latlh tools complex qay' Qaw':

Submodules qay': Submodules lo'taHvIS repositories (e.g., Hugo themes, vendor libraries), usually Hoch submodule git config user.name manually DaSet. extension Hoch active submodules profiles recursively chel, elegantly Qaw'.
SSH & GPG SeH: pong choH neH bIH. ssh-agent SSH keys DachoH, GPG signing DachoH, signature QIH commits yIbot.

ngoQ (Features)

Profile Management UI: settings.json edit without, profiles add, edit, delete, reorder possible
wa' weQ profile switch: Git user.name 'ej user.email instant change
Status bar integration: DaH profile always leghlaH
Sync Check: Profile je git config mismatch real-time detect, status bar warning show
Submodule support: Git submodules automatic profiles propagate
SSH key management: ssh-agent SSH keys automatic switch
GPG signing support: Commit signing GPG keys configure (optional)
Rich tooltips: Description 'ej SSH host profile details
Cross-platform: macOS, Linux, Windows - Hoch platforms!
Multilingual: 17 languages support

🌏 Multilingual je minorities

minorities jIvoq. puS neH chaH jIvoqbe'. Translations perfect bIHbe', 'ach minority languages yaj, respect qaq intent boj.

Extension VS Code Hol 17 qIp. README documentation, minority ethnic languages je joke languages mughwI' jIH.

"global support" neH bIH—"linguistic diversity respect." Hol Hoch, Daq Hoch, developers batlh commits chenmoH... infrastructure vIneH.

Quick Start

Personal account je company-issued account (Enterprise Managed User) Segh typical setup.

Step 1: SSH keys qawmoH

wa'DIch, accounts SSH keys chenmoH (already ghaj skip):

# Personal
ssh-keygen -t ed25519 -C "qapla@personal.example.com" -f ~/.ssh/id_ed25519_personal

# Work
ssh-keygen -t ed25519 -C "qapla@techcorp.example.com" -f ~/.ssh/id_ed25519_work

SSH key public key (.pub file) GitHub account yIchel.

ghu: GitHub id_ed25519_personal.pub (public key) yIchel. id_ed25519_personal (no extension) private key—not share, not upload!

Step 2: SSH config choH

~/.ssh/config yIchoH:

# Personal GitHub account (default)
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_personal
    IdentitiesOnly yes

# Work GitHub account
Host github-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_work
    IdentitiesOnly yes

Step 3: Extension Segh

Install rIntaHvIS sample profiles qawmoHlu'. Guide tlha', SoH choH.

Key files ngeH qet: SSH key He' choH, key file He' (Daq) neH teq. Key file contents ngeHbe', external ngeHbe'.

GPG signing lo': Profile choH screen gpgKeyId choH Datu'. GPG key ID paS mIw "Troubleshooting" legh.

QI': settings.json tI' Segh Datu'. Extension settings poSmoH (Cmd+, / Ctrl+,) → "Git ID Switcher" nej → "Edit in settings.json" wIv. JSON format Segh pIv "Full Example" legh.

pIv naQ: 5 Accounts SSH + GPG

Hoch tay'taH pIv naQ:

SSH Config (`~/.ssh/config`)

# Personal account (default)
Host github-personal
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_personal
    IdentitiesOnly yes

# Work account (company-issued Enterprise Managed User)
Host github-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_work
    IdentitiesOnly yes

# Client A – contract work (Bitbucket)
Host bitbucket-clienta
    HostName bitbucket.org
    User git
    IdentityFile ~/.ssh/id_ed25519_clienta
    IdentitiesOnly yes

# Client B – on-site project (Bitbucket)
Host bitbucket-clientb
    HostName bitbucket.org
    User git
    IdentityFile ~/.ssh/id_ed25519_clientb
    IdentitiesOnly yes

# OSS contributions (GitLab)
Host gitlab-oss
    HostName gitlab.com
    User git
    IdentityFile ~/.ssh/id_ed25519_oss
    IdentitiesOnly yes

Extension Settings

{
  "gitIdSwitcher.identities": [
    {
      "id": "personal",
      "name": "Qapla'",
      "email": "qapla@personal.example.com",
      "service": "GitHub",
      "icon": "⚔️",
      "description": "jIH ta'mey",
      "sshKeyPath": "~/.ssh/id_ed25519_personal",
      "sshHost": "github-personal",
      "gpgKeyId": "ABCD1234EF567890"
    },
    {
      "id": "work-main",
      "name": "Qapla'",
      "email": "qapla@techcorp.example.com",
      "service": "GitHub vum",
      "icon": "🗡️",
      "description": "TechCorp vum'a'",
      "sshKeyPath": "~/.ssh/id_ed25519_work",
      "sshHost": "github-work",
      "gpgKeyId": "9876543210FEDCBA"
    },
    {
      "id": "client-a",
      "name": "Qapla'",
      "email": "qapla@clienta.example.com",
      "service": "Bitbucket",
      "icon": "💪",
      "description": "ClientA mIw",
      "sshKeyPath": "~/.ssh/id_ed25519_clienta",
      "sshHost": "bitbucket-clienta"
    },
    {
      "id": "client-b",
      "name": "Q.Qapla'",
      "email": "q.qapla@clientb.example.com",
      "service": "Bitbucket",
      "icon": "🔥",
      "description": "ClientB Daq",
      "sshKeyPath": "~/.ssh/id_ed25519_clientb",
      "sshHost": "bitbucket-clientb"
    },
    {
      "id": "oss",
      "name": "qapla-dev",
      "email": "qapla.dev@example.com",
      "service": "GitLab",
      "icon": "🏆",
      "description": "OSS boQ",
      "sshKeyPath": "~/.ssh/id_ed25519_oss",
      "sshHost": "gitlab-oss"
    }
  ],
  "gitIdSwitcher.defaultIdentity": "personal",
  "gitIdSwitcher.autoSwitchSshKey": true,
  "gitIdSwitcher.applyToSubmodules": true
}

ghu: profile 4 (client-b) pong mojaq lo'. profile 5 (oss) chenmoH pong lo'. nuv rap qoj profiles pIm pong'e' lo'laH.

Profiles qon

Status bar yIwIv → list bIng "Profile Management" qon screen poSmoH. Profiles chel, choH, teq, tay'—Hoch UI tI' vum Datu'.

Command Palette Git ID Switcher: Delete Identity profile teq je Datu'.

ra' (Commands)

Command	Description
`Git ID Switcher: Select Identity`	Profile picker open
`Git ID Switcher: Delete Identity`	Profile delete
`Git ID Switcher: Show Current Identity`	DaH profile show
`Git ID Switcher: Show Documentation`	Documentation show

Segh leghwI'

Profile Dotlh

Property	Required	Description
`id`	✅	Unique identifier (e.g., `"personal"`, `"work"`)
`name`	✅	Git user.name — commits show
`email`	✅	Git user.email — commits show
`icon`		Status bar emoji (e.g., `"⚔️"`). Single emoji only
`service`		Service name (e.g., `"GitHub"`, `"GitLab"`). UI display use
`description`		Picker 'ej tooltip short description
`sshKeyPath`		SSH private key path (e.g., `"~/.ssh/id_ed25519_work"`)
`sshHost`		SSH config Host alias (e.g., `"github-work"`)
`gpgKeyId`		Commit signing GPG key ID

cha' jen

Status bar: ~25 mI' tIq ... pe'
icon: wa' emoji (grapheme cluster) neH. law' emojis, ngoD potlh Hutlh

Segh Hoch

Setting	Default	Description
`gitIdSwitcher.identities`	Sample	Profile configurations list
`gitIdSwitcher.defaultIdentity`	Sample	Default profile ID use
`gitIdSwitcher.autoSwitchSshKey`	`true`	Profile change SSH keys automatic switch
`gitIdSwitcher.showNotifications`	`true`	Profile switch notification show
`gitIdSwitcher.applyToSubmodules`	`true`	Git submodules profiles propagate
`gitIdSwitcher.submoduleDepth`	`1`	Nested submodules max depth (1-5)
`gitIdSwitcher.includeIconInGitConfig`	`false`	Icon emoji Git config `user.name` include
`gitIdSwitcher.syncCheck.enabled`	`true`	Profile wIvta' git config actual match check
`gitIdSwitcher.syncCheck.onFocusReturn`	`true`	Editor window focus return sync check run
`gitIdSwitcher.logging.fileEnabled`	`false`	Audit logs file save (profile switches, SSH key operations record)
`gitIdSwitcher.logging.filePath`	`""`	Log file path (e.g., `~/.git-id-switcher/security.log`). Empty default use
`gitIdSwitcher.logging.maxFileSize`	`10485760`	Rotation before max file size (bytes, 1MB-100MB)
`gitIdSwitcher.logging.maxFiles`	`5`	Rotation files keep max count (1-20)
`gitIdSwitcher.logging.redactAllSensitive`	`false`	Enable Hoch values mask (maximum privacy mode)
`gitIdSwitcher.logging.level`	`"INFO"`	Log verbosity (`DEBUG`, `INFO`, `WARN`, `ERROR`, `SECURITY`). Selected level above record
`gitIdSwitcher.commandTimeouts`	`{}`	Commands custom timeout values (ms, 1s-5min). E.g., `{"git": 15000, "ssh-add": 10000}`

`includeIconInGitConfig` About

icon field set behavior control:

Value	Behavior
`false` (default)	`icon` editor UI only show. Git config `name` only write
`true`	Git config `icon + name` write. Commit history emoji remain

Example: icon: "👤", name: "Qapla'" case

includeIconInGitConfig	Git config `user.name`	Commit signature
`false`	`Qapla'`	`Qapla' <email>`
`true`	`👤 Qapla'`	`👤 Qapla' <email>`

chay' vum (How It Works)

Git Config layer qach

Git config wej layers; bIng Segh Dung override:

System (/etc/gitconfig)
    ↓ override
Global (~/.gitconfig)
    ↓ override
Local (.git/config)  ← highest priority

Git ID Switcher --local (repository local) ghItlh.

Doch:

Repository .git/config profile choq
Repositories rar profiles pol Datu'
Global settings (~/.gitconfig) choHbe'

Profile choH ngoQ

Profile DachoH, extension (order) vum:

Git Config (reH): git config --local user.name je user.email Datogh
SSH key (sshKeyPath toghta'): latlh keys ssh-agent teq, wIvta' chel
GPG key (gpgKeyId toghta'): git config --local user.signingkey Datogh, signing chu'
Submodules (chu'ta'): Hoch submodules config ngeH (default: depth 1)
Sync Check: Profile applied git config actual match verify

Sync Check

Profile wIvta' git config --local values (user.name, user.email, user.signingkey) actual compare, mismatch detect status bar warning show.

ghorgh checks run:

Profile apply immediately after
Workspace folder change
Configuration change
Editor window focus return (debounce 500ms)

Mismatch detect:

Status bar ⚠️ icon warning background color show
Tooltip mismatch fields table show (field, expected value, actual value)
Status bar click resolution options show:
- Profile reapply — DaH profile git config reapply
- latlh profile wIv — Profile picker open
- Dismiss — Warning suppress next check until

Disable:

gitIdSwitcher.syncCheck.enabled false set, Hoch sync checks disable. Focus-return check only disable, gitIdSwitcher.syncCheck.onFocusReturn false set.

Submodule ngeH mIw

Local config repository qib vum, submodules automatic chelbe'. vaj extension submodule ngeH ngoQ qem (De' "Advanced: Submodule Support" legh).

SSH Key qon De'

Git ID Switcher ssh-agent lo'taHvIS SSH keys qon:

vum	ra' vum
Key chel	`ssh-add <keyPath>`
Key teq	`ssh-add -d <keyPath>`
Key tlha'	`ssh-add -l`

potlh: Extension ~/.ssh/config choHbe'. SSH config Segh manual poQ ("Quick Start" Step 2 legh).

SSH Segh tu'lu'taHvIS vay'

SSH Segh DaghajtaH, Git ID Switcher ngoQ:

SoH Segh	Git ID Switcher ngoQ
`~/.ssh/config` `IdentityFile` DaSegh	cha' Dalo'laH; `IdentitiesOnly yes` yem bot
mi' Deghmey `GIT_SSH_COMMAND` DaSegh	Custom SSH ra' Dalo'; ssh-agent vumtaH
`git config core.sshCommand` DaSegh	Dung rap
direnv SSH mi' Deghmey DaSegh	yIn Datu'; ssh-agent wa'bej vum

Qel: SSH config reH IdentitiesOnly yes yItogh. SSH law' keys wIv botmoH.

qatlh `IdentitiesOnly yes`?

Segh Hutlh, SSH keys wIv order:

ssh-agent loaded keys (Git ID Switcher qon)
~/.ssh/config specified keys
Default keys (~/.ssh/id_rsa, ~/.ssh/id_ed25519, etc.)

Authentication luj, unintended key lo' Datu'.

IdentitiesOnly yes Datogh, SSH specified keys neH lo'. Git ID Switcher toghta' keys bIH lo'.

# QelmeH Segh
Host github-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_work
    IdentitiesOnly yes  # ← ghItlh potlh

Segh toghta', github-work Host jot ~/.ssh/id_ed25519_work neH lo', latlh keys wIvbe'.

po'wI': Submodule qIp

Git submodules lo'taHvIS complex repositories, profile qon DatIv. Submodule commit, Git submodule local config lo'; explicitly Datoghbe', global config (email QIH!) default Datu'.

Git ID Switcher automatic submodules tu', wIvta' profile chel.

{
  "gitIdSwitcher.applyToSubmodules": true,
  "gitIdSwitcher.submoduleDepth": 1
}

applyToSubmodules: ngoQ chu'/mev toggle
submoduleDepth: 'ar depth chel?
- 1: tI' submodules neH (tlhutlh law')
- 2+: Nested submodules (submodules submodules tItDaq)

Main repository commit, vendor library commit—profile reH pIv guarantee.

qay' Qaw' (Troubleshooting)

SSH key choHbe'?

ssh-agent qetlh paS:
```
eval "$(ssh-agent -s)"
```
Key He' pIv paS:
```
ls -la ~/.ssh/id_ed25519_*
```

macOS, wa'logh Keychain chel:

ssh-add --apple-use-keychain ~/.ssh/id_ed25519_work

ngeH profile QIH?

chu' clone:

vum repository clone, SSH config Seghta' host alias lo':

# vum (github-work alias lo')
git clone git@github-work:company/repo.git

# Personal (default github.com lo')
git clone git@github.com:yourname/repo.git

repository tu'lu'ta':

Remote URL pIv host alias lo' paS:

git remote -v
# vum repository git@github-work:... cha' poQ

poQlu' choH:

git remote set-url origin git@github-work:company/repo.git

GPG signing vumbe'?

GPG key ID paS:

gpg --list-secret-keys --keyid-format SHORT

Signing wIv:
```
echo "test" | gpg --clearsign
```
Profile email GPG key email rap paS

Profile tu'be'?

Git repository tItDaq paS
settings.json syntax Qagh yInej
VS Code window yIchu'qa' (Cmd+Shift+P → "Reload Window")

`name` De' Qagh?

name De' mI' bIH ngaS Qagh:

` $ ( ) { } | & < >

Service pong ngaS DaneH, service De' yIlo'.

// QIH
"name": "Qapla' (Personal)"

// pIv
"name": "Qapla'",
"service": "GitHub"

chu' Segh cha'be'?

Extension choHta', chu' Segh Segh screen cha'be'.

Qaw': Machine naQ yIchu'qa'.

VS Code editors Segh schema yab cache, "Reload Window" pagh reinstall naQbe'.

Default values (identities etc.) chIm?

chu' install sample Segh cha'be', Settings Sync qaSmoH.

ret chIm Segh choqta', cloud sync, chu' install default values override.

Qaw':

Segh screen Segh yItu'
Gear icon → "Reset Setting" yIwIv
Settings Sync sync (qan Segh cloud yIteq)

meqba' QeD (Design Philosophy)

"jIH 'Iv?" — wa' yu'wI' extension jang.

Karesansui Architecture lo'lu'. Core 100 ghItlhmey nap. vaj remaining quality (test 90%, logging, timeouts) je intentional constraints (GitHub API Hutlh, token qon Hutlh) lo' Datu'.

meqba' naQ yIlaD

boq (Contributing)

boq SuqeH! CONTRIBUTING.md yIlaD.

chut (License)

MIT chut - LICENSE yIlaD.

quvmoH (Credits)

Null;Variant chenmoHta'

🖖 Qapla'! batlh Daqawlu'taH! 🖖

(Success! You will be remembered with honor!)

Uh oh!

FilesExpand file tree

README.md

Latest commit

History