gitswitch

分类: 工具与效率 | 上传者: aksisonline | 下载: 0 | 版本: v1.0（最新）

当用户使用错误的帐户提交或推送时，使用 gitswitch 工具切换 git 身份和 GitHub 帐户。每当用户提及以下内容时，请使用此技能：他们的提交显示错误的姓名/电子邮件、推送到错误的 GitHub 帐户、需要切换 git 配置文件、想要检查哪个 git 身份处于活动状态、提交时出现归因错误、跨多个 GitHub 帐户（个人与工作、多个客户端）工作，或者任何时候 git/GitHub 上下文中出现短语“错误帐户”或“错误身份”。不要等待用户说“gitswitch”——如果问题听起来像是 git 身份不匹配，请调用此技能。 --- # gitswitch 技能 `gitswitch` 是一个终端工具（通过 Homebrew 或curl 安装），用于管理多个本地 git 身份。它可以通过一个命令一次性切换 `git config user.name`、`git config user.email`、SSH 密钥和（可选）`gh` CLI 帐户。 ## 何时使用每当出现以下情况时，请访问 `gitswitch`： - 提交以错误的作者姓名或电子邮件登陆 - 用户即将推送到工作/客户端存储库，但仍使用其个人身份 - 用户询问“我在哪个 git 帐户上？” - 用户需要为新工作、客户或副项目添加新的配置文件 - 用户对为什么 `gh` 和 `git` 显示不同的帐户（它们是独立的）感到困惑 ## 步骤 1 — 诊断在执行任何操作之前始终检查当前活动的内容： ```bash gitswitch current # 显示活动的配置文件名称 + 电子邮件 gitswitch list # 显示所有配置文件，✓ 标记活动的配置文件 ``` 如果未安装 `gitswitch`，请明确说明并提供安装说明： ```bash # Homebrew（推荐）：brew install aksisonline/tap/gitswitch # 或者，不使用 Homebrew（curl 单行）：

更新日志: Source: GitHub https://github.com/aksisonline/gitswitch

目录结构

当前层级: tree/main/cmd/gitswitch/skill/

📄 SKILL.md 7.6 KB

SKILL.md

---
name: gitswitch
description: >
  Switch git identity and GitHub account using the gitswitch tool when the user is
  committing or pushing as the wrong account. Use this skill whenever the user mentions:
  their commits showing the wrong name/email, pushing to the wrong GitHub account,
  needing to switch git profiles, wanting to check which git identity is active,
  getting attribution errors on commits, working across multiple GitHub accounts
  (personal vs work, multiple clients), or any time the phrase "wrong account" or
  "wrong identity" appears in a git/GitHub context. Don't wait for the user to say
  "gitswitch" — if the problem smells like a git identity mismatch, invoke this skill.
---

# gitswitch skill

`gitswitch` is a terminal tool (installed via Homebrew or curl) that manages multiple local git identities. It switches `git config user.name`, `git config user.email`, the SSH key, and (optionally) the `gh` CLI account — all at once, with one command.

## When to use it

Reach for `gitswitch` whenever:
- A commit landed with the wrong author name or email
- The user is about to push to a work/client repo but is still on their personal identity
- The user asks "which git account am I on?"
- The user needs to add a new profile for a new job, client, or side project
- The user is confused about why `gh` and `git` show different accounts (they're independent)

## Step 1 — Diagnose

Always check what's currently active before doing anything:

```bash
gitswitch current     # shows active profile name + email
gitswitch list        # shows all profiles, ✓ marks the active one
```

If `gitswitch` is not installed, say so clearly and offer the install instructions:
```bash
# Homebrew (recommended):
brew install aksisonline/tap/gitswitch

# Or, without Homebrew (curl one-liner):
curl -fsSL https://raw.githubusercontent.com/aksisonline/gitswitch/main/.github/install.sh | bash
```

## Step 2 — Switch to the right profile

If the right profile already exists:

```bash
gitswitch <nickname>
# e.g. gitswitch work
```

That's it. One command applies `user.name`, `user.email`, the SSH key, and runs `gh auth switch` if a GitHub username is stored in the profile.

If the user needs to pick from a list, show them `gitswitch list` output and ask which one.

## Step 3 — Create a profile if it doesn't exist yet

```bash
gitswitch add <nickname> "<Full Name>" <email> [flags]

# Common flags:
#   --ssh-key ~/.ssh/id_work       force a specific SSH key
#   --gh-user <github-handle>      also switch gh CLI account
#   --sign-key <GPG-key-ID>        for signed commits

# Examples:
gitswitch add work "Alice Smith" alice@company.com --ssh-key ~/.ssh/id_work --gh-user alice-corp
gitswitch add personal "Alice Smith" alice@gmail.com --ssh-key ~/.ssh/id_personal --gh-user alice
gitswitch add clienta "Alice Smith" alice@clienta.com --ssh-key ~/.ssh/id_clienta
```

After adding, switch immediately:
```bash
gitswitch work
```

## Step 4 — Verify

```bash
gitswitch current     # confirm the new identity is active
git config --global user.email   # double-check git sees it
```

If the user had already made commits with the wrong identity on a branch, let them know that `gitswitch` fixes *future* commits — amending history is a separate step (and usually unnecessary unless they haven't pushed yet).

---

## Identity awareness — shell integration

`gitswitch install` sets up three things at once:

```bash
gitswitch install
```

- **Prompt segment** — shows current git identity in your shell prompt
- **Identity nudge** — when you `cd` into a repo, suggests the identity you usually use there
- **Tab completion** — completes commands and profile nicknames

Detects your prompt framework automatically (Starship, oh-my-zsh, Powerlevel10k, or raw zsh/bash/fish) and installs the right way for each. Idempotent — safe to run multiple times.

After running, reload your shell:
```bash
source ~/.zshrc   # or open a new terminal
```

---

## Pinning an identity to a repo

If you always want a specific identity recommended for a repo regardless of usage history:

```bash
gitswitch pin work      # always recommend 'work' in this repo
gitswitch unpin         # remove the pin, fall back to auto-recommendation
```

The pin takes permanent priority over the auto-learned counts. `unpin` reverts to the usage-based recommender.

---

## How the auto-recommender works

`gitswitch` tracks which identity is active each time you enter a repo (via the shell cd hook). When the top identity has **≥3 entries** and **≥60% share** and differs from your current identity, it nudges:

```
gitswitch: this repo usually uses work <alice@company.com> — switch? [y/N]
```

One keypress. Defaults to N if you ignore it.

To manually record the current identity for the current repo:
```bash
gitswitch record
```

To check what would be recommended right now:
```bash
gitswitch recommend     # exits 0 + prints nickname/name/email if nudge warranted
                        # exits 1 silently if already on the right identity or no data
```

---

## Common scenarios

### "My commits on GitHub show my personal email at my work repo"
```bash
gitswitch list           # find the work profile name
gitswitch work           # switch to it
```
Then for future commits they'll be fine. If they need to fix the last commit:
```bash
git commit --amend --reset-author --no-edit
```

### "I have two GitHub accounts and keep using the wrong one"
```bash
gitswitch add personal "Name" personal@email.com --ssh-key ~/.ssh/id_personal --gh-user my-handle
gitswitch add work     "Name" work@email.com     --ssh-key ~/.ssh/id_work     --gh-user my-corp-handle
# then before each session:
gitswitch personal   # or: gitswitch work
```

### "I want gitswitch to always remind me to use the right account in a repo"
```bash
gitswitch install        # sets up the shell nudge hook
gitswitch pin work       # optional: force 'work' regardless of history
```

### "Is this tool the same as `gh auth switch`?"
No — they solve different problems:
- `gh auth switch` changes which account the **`gh` CLI** (API tokens) uses
- `gitswitch` changes your **commit identity** (`user.name` / `user.email`) and SSH key

You often need both. `gitswitch` calls `gh auth switch` automatically if you stored a `--gh-user` in the profile.

### "I want to see my profiles in a UI"
```bash
gitswitch     # opens the interactive TUI, use ↑↓ to navigate, Enter to switch
```

---

## All commands

| Command | What it does |
|---------|-------------|
| `gitswitch` | Open interactive TUI |
| `gitswitch <name>` | Quick switch (no UI) |
| `gitswitch list` | List all profiles |
| `gitswitch current` | Show active profile |
| `gitswitch current --short` | Output `nickname\temail` (used by Starship prompt) |
| `gitswitch add …` | Add a new profile |
| `gitswitch remove <name>` | Delete a profile |
| `gitswitch pin <name>` | Pin an identity to the current repo permanently |
| `gitswitch unpin` | Remove pin, fall back to usage-based recommendation |
| `gitswitch record` | Log current identity for this repo (called by shell hooks) |
| `gitswitch recommend` | Print recommended identity if threshold met |
| `gitswitch install` | Set up shell prompt segment, nudge hook, and tab completion |
| `gitswitch claude` | Install this skill into Claude Code (~/.claude/skills) |
| `gitswitch claude --scope project` | Install skill for this project only (.claude/skills) |
| `gitswitch init` | Re-import current `git config` as `default` |
| `gitswitch version` | Show version, check for updates |
| `gitswitch upgrade` | Upgrade to latest release |

Profiles stored at `~/.config/gitswitch/profiles.json`.
Usage history stored at `~/.config/gitswitch/history.json`.

登录后下载/点赞/收藏 ❤ 9 | ★ 0

gitswitch

目录结构

SKILL.md

举报内容

提示