Git ID Switcher

⚠️ アイヌイタㇰ翻訳について

この翻訳は実験的なものであり、誤りを含む可能性があります。ネイティブスピーカーの方からの修正PRを心よりお待ちしています。

タンウコイタㇰウタㇻオロワコㇿカㇺアンルウェネ。ピㇼカウタㇻオロワアイヌイタㇰウコイタㇰエラマンクㇽエアㇻキ。

📚 アイヌイタㇰについて学ぶ / Learn More About Ainu

アイヌ語（アイヌイタㇰ）は、日本の北海道・樺太・千島列島で話されてきた言語です。現在はユネスコにより「極めて深刻な危機」に分類されていますが、復興の取り組みが進められています。

シネㇷ゚クリㇰオロワ Git ID ウコイタㇰウタㇻホㇱキノエトゥㇾ。GitHub アカウント、SSH キー、GPG サインオロワノウコイタㇰ、Git Submodule オロワノ ID ウコイタㇰ。

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

🎯 ネーンクスタン Extension?

Git ID ウコイタㇰ Extension ポㇿアン、Git ID Switcher ウタㇻオㇿケピㇼカノ:

Submodule: submodule アン repository オロワ、シネㇷ゚シネㇷ゚ git config user.name エキクスネ。タン extension オロワ submodule オㇿ ID ウコイタㇰ。
SSH & GPG: レーエトゥㇾアイヌ、SSH キーウン GPG サインエキ。

ピㇼカウタㇻ (Features / 機能)

Submodule: Git submodule オロワノ ID ウコイタㇰ
SSH キーウコイタㇰ: ssh-agent オロワ SSH キーウコイタㇰ
GPG サイン: commit サイン GPG キー (オプション)
シネㇷ゚クリㇰオロワ ID ウコイタㇰ: Git user.name ウン user.email ホㇱキノエトゥㇾ
ステータスバー: エネアン ID エヌカㇻ
ツールチップ: ID ウタㇻオロワ
macOS, Linux, Windows: オㇿケウトゥㇺ
17 イタㇰ: ウコイタㇰウタㇻ

🌏 イタㇰウタㇻオロワ

ポンウタㇻオロワノピㇼカアン。 ポンノアンクスホㇱキエヤㇺシㇼソモキ。ピㇼカノウコイタㇰエアㇻキシㇼソモネヤㇰカ、ポンイタㇰオロワピㇼカノエヌカㇻクスエラㇺ。

タン extension オロワ VSCode 17 イタㇰオㇿ。README オロワ、ポンイタㇰウンホㇱキㇷ゚イタㇰオロワノ。

ホㇱキノ (Quick Start / クイックスタート)

ウタㇻアカウントウンモノレアカウント (Enterprise Managed User) ウコイタㇰ。

1: SSH キー

SSH キーエキ (アンヤㇰカエレㇷ゚):

# ウタㇻ (Personal / 個人用)
ssh-keygen -t ed25519 -C "sisam@personal.example.com" -f ~/.ssh/id_ed25519_personal

# モノレ (Work / 仕事用)
ssh-keygen -t ed25519 -C "sisam@company.example.com" -f ~/.ssh/id_ed25519_work

シネㇷ゚シネㇷ゚ 公開鍵 (.pub ファイル) GitHub アカウントオロワ。

ウタㇻ: GitHub オロワ id_ed25519_personal.pub (公開鍵)。id_ed25519_personal (拡張子ナシ) 秘密鍵—ホㇱキアンソモキ。

2: SSH Config

~/.ssh/config エトゥㇾ:

# ウタㇻ アカウント
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_personal
    IdentitiesOnly yes

# モノレ アカウント
Host github-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_work
    IdentitiesOnly yes

3: Extension

Extension 設定 (Cmd+, / Ctrl+,) → "Git ID Switcher" エヌカㇻ → "settings.json エトゥㇾ" クリㇰ:

{
  "gitIdSwitcher.identities": [
    {
      "id": "personal",
      "name": "シサㇺ",
      "email": "sisam@personal.example.com",
      "service": "GitHub",
      "icon": "🏠",
      "description": "ウタㇻ プロジェクト",
      "sshKeyPath": "~/.ssh/id_ed25519_personal"
    },
    {
      "id": "work",
      "name": "シサㇺ",
      "email": "sisam@company.example.com",
      "service": "GitHub モノレ",
      "icon": "💼",
      "description": "モノレ",
      "sshKeyPath": "~/.ssh/id_ed25519_work",
      "sshHost": "github-work"
    }
  ],
  "gitIdSwitcher.defaultIdentity": "personal",
  "gitIdSwitcher.autoSwitchSshKey": true,
  "gitIdSwitcher.applyToSubmodules": true
}

4: エキ!

ステータスバー ID アイコンクリㇰ (ハヨㇰペシㇼペ)
ID エトゥㇾ
オㇿケ! Git config ウン SSH キーウコイタㇰ。

SSH Host エイリアス

Repository クローン、ID オロワ Host エキ:

# モノレ ID (github-work エイリアス)
git clone git@github-work:company/repo.git

# ウタㇻ ID (github.com デフォルト)
git clone git@github.com:sisam/repo.git

オプション: GPG サイン

GPG オロワ commit サイン:

1: GPG キー ID エヌカㇻ

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

例:

sec   ed25519/ABCD1234 2024-01-01 [SC]
      ...
uid         [ultimate] シサㇺ <sisam@personal.example.com>

キー ID ABCD1234。

2: GPG キー ID オロワ

{
  "gitIdSwitcher.identities": [
    {
      "id": "personal",
      "name": "シサㇺ",
      "email": "sisam@personal.example.com",
      "service": "GitHub",
      "icon": "🏠",
      "description": "ウタㇻ プロジェクト",
      "sshKeyPath": "~/.ssh/id_ed25519_personal",
      "gpgKeyId": "ABCD1234"
    }
  ]
}

タン ID ウコイタㇰ、extension エキ:

git config user.signingkey ABCD1234
git config commit.gpgsign true

例: 4 アカウント SSH + GPG

オㇿ例:

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

# ウタㇻ アカウント (デフォルト)
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_personal
    IdentitiesOnly yes

# モノレ アカウント
Host github-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_work
    IdentitiesOnly yes

# Bitbucket アカウント
Host bitbucket.org
    HostName bitbucket.org
    User git
    IdentityFile ~/.ssh/id_ed25519_bitbucket
    IdentitiesOnly yes

Extension 設定

{
  "gitIdSwitcher.identities": [
    {
      "id": "personal",
      "name": "シサㇺ",
      "email": "sisam@personal.example.com",
      "service": "GitHub",
      "icon": "🏠",
      "description": "ウタㇻ プロジェクト",
      "sshKeyPath": "~/.ssh/id_ed25519_personal",
      "gpgKeyId": "PERSON12"
    },
    {
      "id": "work",
      "name": "シサㇺ",
      "email": "sisam@company.example.com",
      "service": "GitHub モノレ",
      "icon": "💼",
      "description": "モノレ アカウント",
      "sshKeyPath": "~/.ssh/id_ed25519_work",
      "sshHost": "github-work",
      "gpgKeyId": "WORK1234"
    },
    {
      "id": "bitbucket",
      "name": "シサㇺ",
      "email": "sisam@bitbucket.example.com",
      "service": "Bitbucket",
      "icon": "🪣",
      "description": "Bitbucket プロジェクト",
      "sshKeyPath": "~/.ssh/id_ed25519_bitbucket",
      "sshHost": "bitbucket.org"
    },
    {
      "id": "sirokan",
      "name": "シサㇺ",
      "email": "sisam@freelance.example.com",
      "service": "GitLab",
      "icon": "🎯",
      "description": "シㇿカン プロジェクト"
    }
  ],
  "gitIdSwitcher.defaultIdentity": "personal",
  "gitIdSwitcher.autoSwitchSshKey": true,
  "gitIdSwitcher.applyToSubmodules": true
}

ウタㇻ: ホㇱキ ID (sirokan) SSH ソモ—Git config ウコイタㇰワノ。GitLab アカウントエネアン commit ウタㇻオロワ。

設定リファレンス (Configuration Reference)

ID プロパティ (Identity Properties)

プロパティ	必須	ウコイタㇰ
`id`	✅	ユニーク ID (例: `"work"`, `"personal"`)
`name`	✅	Git user.name — commit オロワ
`email`	✅	Git user.email — commit オロワ
`icon`		ステータスバー絵文字 (例: `"🏠"`)。シネㇷ゚絵文字ワノ
`service`		サービスレー (例: `"GitHub"`, `"GitLab"`)。UI オロワ
`description`		ピッカーウンツールチップオロワ
`sshKeyPath`		SSH 秘密鍵パス (例: `"~/.ssh/id_ed25519_work"`)
`sshHost`		SSH config ホストエイリアス (例: `"github-work"`)
`gpgKeyId`		GPG キー ID commit サイン

表示制限 (Display Limitations)

ステータスバー: ~25 文字 ... オロワ
icon: シネㇷ゚絵文字 (grapheme cluster) ワノ。ポㇿ絵文字ロングテキストソモキ

設定 (General Settings)

設定	デフォルト	ウコイタㇰ
`gitIdSwitcher.identities`	例エヌカㇻ	ID 設定リスト
`gitIdSwitcher.defaultIdentity`	例エヌカㇻ	デフォルト ID
`gitIdSwitcher.autoSwitchSshKey`	`true`	SSH キーウコイタㇰ
`gitIdSwitcher.showNotifications`	`true`	ウコイタㇰ通知
`gitIdSwitcher.applyToSubmodules`	`true`	Git submodule ID ウコイタㇰ
`gitIdSwitcher.submoduleDepth`	`1`	ネスト submodule 深さ (1-5)
`gitIdSwitcher.includeIconInGitConfig`	`false`	絵文字 icon Git config `user.name` オロワ
`gitIdSwitcher.logging.fileEnabled`	`false`	監査ログファイルオロワ（ID ウコイタㇰ、SSH 操作等）
`gitIdSwitcher.logging.filePath`	`""`	ログファイルパス（例：`~/.git-id-switcher/security.log`）。空 = デフォルト
`gitIdSwitcher.logging.maxFileSize`	`10485760`	ローテーション前最大ファイルサイズ（バイト、1MB-100MB）
`gitIdSwitcher.logging.maxFiles`	`5`	保持ローテーションファイル最大数（1-20）
`gitIdSwitcher.logging.level`	`"INFO"`	ログレベル：`DEBUG`/`INFO`/`WARN`/`ERROR`/`SECURITY`。選択レベル以上記録
`gitIdSwitcher.logging.redactAllSensitive`	`false`	ウコイタㇰ、タントウンコラムパコロマスク（最大プライバシー）
`gitIdSwitcher.commandTimeouts`	`{}`	コマンドタイムアウト（ミリ秒、1秒-5分）。例：`{"git": 15000, "ssh-add": 10000}`

`includeIconInGitConfig` オロワ

icon フィールド設定動作:

値	動作
`false` (デフォルト)	`icon` エディタ UI ワノ。`name` ワノ Git config オロワ
`true`	`icon + name` Git config オロワ。絵文字 commit 履歴オロワ

例: icon: "👤", name: "シサㇺ"

includeIconInGitConfig	Git config `user.name`	Commit サイン
`false`	`シサㇺ`	`シサㇺ <email>`
`true`	`👤 シサㇺ`	`👤 シサㇺ <email>`

ウタㇻ: 基本設定 (SSH ソモ)

SSH キーウコイタㇰソモ (例、GitHub アカウントエネアン commit ウタㇻオロワ)、ポン設定エキ:

{
  "gitIdSwitcher.identities": [
    {
      "id": "personal",
      "name": "シサㇺ",
      "email": "sisam@personal.example.com",
      "icon": "🏠",
      "description": "ウタㇻ プロジェクト"
    },
    {
      "id": "work",
      "name": "シサㇺ",
      "email": "sisam@company.example.com",
      "icon": "💼",
      "description": "モノレ"
    }
  ]
}

タン設定 git config user.name ウン user.email ワノウコイタㇰ。

エキ (How It Works)

Git Config 構造 (Git Config Layer Structure)

Git config 3 レイヤー; ハヨㇰペレイヤーリㇰンペオロワ:

システム (/etc/gitconfig)
    ↓ オロワ
グローバル (~/.gitconfig)
    ↓ オロワ
ローカル (.git/config)  ← コㇿケㇷ゚

Git ID Switcher --local (repository ローカル) オロワ。

タンウタㇻ:

ID シネㇷ゚シネㇷ゚ repository .git/config ファイルオロワ
シネㇷ゚シネㇷ゚ repository エネアン ID オロワ
グローバル設定 (~/.gitconfig) ウコイタㇰソモキ

ID ウコイタㇰ動作 (Identity Switching Behavior)

ID ウコイタㇰ、extension エキ (順番):

Git Config (常に): git config --local user.name ウン user.email 設定
SSH キー (sshKeyPath 設定): ssh-agent オロワキーエレㇷ゚、エトゥㇾキーオロワ
GPG キー (gpgKeyId 設定): git config --local user.signingkey 設定ウンサインオロワ
Submodule (オロワ): オㇿ submodule 設定オロワ (デフォルト: 深さ 1)

Submodule 伝播 (Submodule Propagation Mechanism)

ローカル設定 repository レベルオロワ、submodule オロワソモキ。タン extension submodule 伝播機能オロワ ("アドバンスド: Submodule" エヌカㇻ)。

アドバンスド: Submodule (Advanced: Submodule Support)

Git submodule アン repository、ID ウコイタㇰピㇼカノソモキ。Submodule commit、Git タン submodule ローカル設定エキ; 設定ソモ、グローバル設定オロワ (email ウェン!)。

Git ID Switcher submodule エヌカㇻウン ID オロワ。

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

applyToSubmodules: タン機能オロワ/ソモ
submoduleDepth: ネーン深さ?
- 1: 直接 submodule ワノ (マウ)
- 2+: ネスト submodule (submodule オロワ submodule)

タン ID 常にピㇼカ、メイン repository ウン vendor ライブラリ commit。

トラブルシューティング (Troubleshooting)

SSH キーウコイタㇰソモキ?

ssh-agent エキエヌカㇻ:
```
eval "$(ssh-agent -s)"
```
キーパスエヌカㇻ:
```
ls -la ~/.ssh/id_ed25519_*
```

macOS、Keychain オロワシネㇷ゚:

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

Push ID ウェン?

リモート URL ホストエイリアスエヌカㇻ:

git remote -v
# モノレ repository git@github-work:... オロワ

オロワ:

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

GPG サインソモキ?

GPG キー ID エヌカㇻ:

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

サインテスト:
```
echo "test" | gpg --clearsign
```
ID email ウン GPG キー email エネアンエヌカㇻ。

ID エヌカㇻソモキ?

Git repository オロワエヌカㇻ
settings.json シンタックスエラーエヌカㇻ
VS Code ウィンドウリロード (Cmd+Shift+P → "Reload Window")

`name` フィールドエラー?

name フィールドタン文字アン、エラー:

` $ ( ) { } | & < >

サービスレーオロワ、service フィールドエキ。

// ウェン
"name": "シサㇺ (ウタㇻ)"

// ピㇼカ
"name": "シサㇺ",
"service": "GitHub"

新設定エヌカㇻソモキ?

Extension アップデート、新設定設定画面エヌカㇻソモ。

ホㇱキ: マシンリスタート。

VS Code 設定スキーマメモリキャッシュ、"Reload Window" ウン reinstall ソモ。

デフォルト値 (identities 等) カㇻ?

新インストールサンプル設定エヌカㇻソモ、Settings Sync オロワ。

カㇻ設定マウ保存、クラウド sync オロワ新インストールデフォルト値オロワ。

ホㇱキ:

設定画面設定エヌカㇻ
歯車アイコン → "設定リセット" エトゥㇾ
Settings Sync sync (カㇻ設定クラウドエレㇷ゚)

コマンド

コマンド	ウコイタㇰ
`Git ID Switcher: Select Identity`	ID ピッカー
`Git ID Switcher: Show Current Identity`	エネアン ID エヌカㇻ
`Git ID Switcher: Show Documentation`	ドキュメントエヌカㇻ

Design Philosophy

「クアニネノネ?」— クコロ extension ネイタハウェアン。

Karesansui Architecture コㇿカアラ: simple core (100 lines), deliberate quality (90% coverage, logging, timeouts) オッタ intentional constraints (GitHub API アㇰ、token management アㇰ)。

Full philosophy エヌカㇻ

Contributing

CONTRIBUTING.md エヌカㇻ。

License

MIT License - LICENSE エヌカㇻ。

Credits

Null;Variant オロワ

🐻 イヤイライケレ! 🐻

Uh oh!

FilesExpand file tree

README.md

Latest commit

History