gitpro

gitpro

为每个仓库选择正确的 Git 身份、SSH 密钥和签名。

gitpro.dev · PyPI · VS Code · 由 Yantrakar 制作

在公司仓库中工作时，使用工作邮箱提交。切换到个人项目时，使用个人身份。Gitpro 根据远程 URL选择身份，而不是根据你恰好将仓库克隆到的位置。

如果你有多个 GitHub/GitLab 账户、工作和个人密钥需要分开，或总是发现提交中使用了错误的邮箱，Gitpro 就很有用。

试用

需要 Linux 或 macOS、Git 2.36+、Python 3.9+ 和 OpenSSH。 通过 pipx 从 PyPI 安装。

pipx install gitpro
gitpro setup

设置程序会询问是否扫描你的仓库，并推荐你的身份。你可以接受、编辑或自行回答问题；**无需编辑 TOML。**一个预览会展示所有内容，包括提交保护，以及 Claude Code 的钩子和 MCP 服务。确认一次即可全部应用。设置程序不会修改你的仓库。

flowchart LR
  S["gitpro setup"] --> HC{"Config <br/>exists?"}
  HC -->|no| L["Read your repos, <br/>SSH config and <br/>editor recents, <br/>if you agree"]
  L --> Q["Propose <br/>identities; you <br/>accept or edit"]
  Q --> I
  HC -->|yes| I["Inspect config, <br/>Git and SSH files, <br/>keys, guard, <br/>agent hook, MCP"]
  I -->|all current| OK["Nothing <br/>to do"]
  I -->|something to do| PV["One preview, <br/>each part with <br/>its undo"]
  PV --> ASK{"Apply <br/>all?"}
  ASK -->|no| NONE["Nothing <br/>written"]
  ASK -->|yes| AP["Write it, print <br/>the public keys <br/>to register"]
  AP --> NX["Next: <br/>gitpro scan"]

然后：

gitpro why               # inside a repository: the expected identity and anything overriding it
gitpro scan              # repos that need a fix, with the command for each

已经有配置？运行 gitpro setup，即可让这台机器与配置保持同步。gitpro setup -n 只会显示尚待完成的事项。想要直接编辑文件？用户指南介绍了完整的 TOML 格式。

你将获得

• **工作与个人身份分离：**按主机/所有者设置名称、邮箱、SSH 密钥和签名。
• 明确答案，而非猜测：gitpro why 会解释不匹配之处并建议修复方法。
• **安全保障：**可选钩子可以阻止使用错误身份的提交和推送。
• **编辑器与容器支持：**在 VS Code 中查看你的身份，并将其带入开发容器。

Gitpro 会生成常规的 Git 和 SSH 配置；无需后台服务。可以预览更改，已有的手动编写文件会先备份，设置过程中绝不会上传密钥。

使用 VS Code？

此扩展会显示当前身份，并帮助查找仓库级覆盖设置。它运行的命令与终端相同。安装扩展。

需要时深入了解

AI Agent 可以通过 MCP 服务和 Claude Code 钩子获取相同的答案：请参阅 Agent 工作流。

我想……	从这里开始
了解匹配规则、SSH 密钥或签名	配置
查找错误身份或遗忘的工作	日常使用 · 查找事项
使用开发容器	容器设置
配置团队策略、CI 或 AI 助手	团队与 CI · AI 助手
查阅命令或撤销更改	命令参考 · 撤销
排查问题或参与贡献	故障排除 · 开发

问题与疑问

运行 gitpro report，即可创建包含版本信息和已脱敏 gitpro why 输出的问题草稿；它会先显示草稿，只有你确认后才会打开问题页面。也可以在 github.com/Yantrakar/gitpro/issues 提交问题。 如安全政策所述，请使用 gitpro report --security 私下报告安全问题，不要在公开问题中报告。

许可证

MIT