git-ai

Git AI 是一个开源的 Git 扩展工具，用于追踪你代码仓库中的 AI 生成代码。

安装后，它会自动将每一行 AI 编写的代码关联到生成它的 AI Agent（智能体）、模型（Model）以及对话记录（Transcripts），确保你永远不会丢失代码背后的意图、需求和架构决策。

每次提交都带有 AI 归属信息：

git commit

[hooks-doctor 0afe44b2] wsl compat check
 2 files changed, 81 insertions(+), 3 deletions(-)
you  ██░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ai
     6%             mixed   2%             92%

AI Blame 显示每行代码背后的模型、Agent 和会话：

git-ai blame /src/log_fmt/authorship_log.rs

cb832b7 (Aidan Cunniffe      2025-12-13 08:16:29 -0500  133) pub fn execute_diff(
cb832b7 (Aidan Cunniffe      2025-12-13 08:16:29 -0500  134)     repo: &Repository,
cb832b7 (Aidan Cunniffe      2025-12-13 08:16:29 -0500  135)     spec: DiffSpec,
cb832b7 (Aidan Cunniffe      2025-12-13 08:16:29 -0500  136)     format: DiffFormat,
cb832b7 (Aidan Cunniffe      2025-12-13 08:16:29 -0500  137) ) -> Result<String, GitAiError> {
fe2c4c8 (claude [session_id] 2025-12-02 19:25:13 -0500  138)     // Resolve commits to get from/to SHAs
fe2c4c8 (claude [session_id] 2025-12-02 19:25:13 -0500  139)     let (from_commit, to_commit) = match spec {
fe2c4c8 (claude [session_id] 2025-12-02 19:25:13 -0500  140)         DiffSpec::TwoCommit(start, end) => {
fe2c4c8 (claude [session_id] 2025-12-02 19:25:13 -0500  141)             // Resolve both commits
fe2c4c8 (claude [session_id] 2025-12-02 19:25:13 -0500  142)             let from = resolve_commit(repo, &start)?;...

支持的 Agent（智能体）

+ 添加对其他 Agent 的支持

安装

Mac、Linux、Windows（WSL）

curl -sSL https://usegitai.com/install.sh | bash

Windows（非 WSL）

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://usegitai.com/install.ps1 | iex"

就这样 —— 无需为每个仓库单独配置。像平常一样提示（prompt）并提交即可。Git AI 会自动追踪归属信息。

我们的设计理念

• 无需改变工作流 —— 只需正常提示和提交。Git AI 能准确追踪 AI 代码，且不会污染你的 Git 历史。
• “检测”AI 代码是一种反模式 —— Git AI 不会猜测某段代码是否由 AI 生成。受支持的 Agent 会明确报告它们编写了哪些行，从而提供最准确的归属信息。
• 本地优先（Local-first） —— 完全离线运行，无需登录。
• 原生集成 Git 并采用开放标准 —— Git AI 使用基于 开放标准 的 Git Notes 来追踪 AI 生成的代码。
• 对话记录不存入 Git —— Git Notes 仅包含指向对话记录的指针，这些记录可存储在本地、Git AI 云服务或自托管的提示存储中，确保你的仓库保持精简、不含敏感信息，并让你完全掌控自己的数据。

个人使用	团队协作
AI 作者信息存储在 Git Notes 中，指针指向本地 SQLite 存储的对话记录 对话记录仅保存在本地计算机上 可随时重启任意对话记录 使用 git-ai stats 跨提交统计 AI 代码占比	AI 作者信息存储在 Git Notes 中，指针指向云端或自托管的对话记录存储，内置访问控制、密钥脱敏和 PII（个人身份信息）过滤 Agent 和工程师可查看任意 AI 生成代码块的原始对话记录和摘要 任何贡献者均可重启任意对话记录 提供高级跨 Agent 仪表盘，用于衡量团队的 AI 采用率、代码持久性，并比较不同 Agent 的表现 点击此处申请抢先体验

通过 /ask 技能理解“为什么”

看到不理解的代码？/ask 技能让你直接与编写该代码的 Agent 对话，了解其指令、决策过程，以及分配任务的工程师的原始意图。

Git AI 在安装时会自动将 /ask 技能添加到 ~/.agents/skills/ 和 ~/.claude/skills/ 目录中，因此你可以在 Cursor、Claude Code、Copilot、Codex 等工具中直接输入 /ask 来调用：

/ask Why didn't we use the SDK here?

能够访问原始意图和源代码的 Agent 才真正理解“为什么”。仅能阅读代码的 Agent 只能告诉你代码“做了什么”，但无法解释“为什么这样做”：

让你的智能体（Agents）更聪明

当智能体理解其所构建代码背后的需求和决策时，它们会犯更少的错误，并产出更易维护的代码。提供这种上下文的最佳方式，就是给智能体配备与你自己使用的相同的 /ask 工具。告诉你的智能体在计划模式（plan mode）下使用 /ask：

Claude|AGENTS.md

- 在计划模式下，始终使用 /ask 技能来阅读代码及其生成时的原始对话记录（transcript）。理解意图将帮助你制定更好的计划。

AI Blame（AI 代码归属）

Git AI blame 是 git blame 的直接替代品，用于显示每一行代码的 AI 归属信息。它支持 所有标准的 git blame 参数。

git-ai blame /src/log_fmt/authorship_log.rs

cb832b7 (Aidan Cunniffe 2025-12-13 08:16:29 -0500  133) pub fn execute_diff(
cb832b7 (Aidan Cunniffe 2025-12-13 08:16:29 -0500  134)     repo: &Repository,
cb832b7 (Aidan Cunniffe 2025-12-13 08:16:29 -0500  135)     spec: DiffSpec,
cb832b7 (Aidan Cunniffe 2025-12-13 08:16:29 -0500  136)     format: DiffFormat,
cb832b7 (Aidan Cunniffe 2025-12-13 08:16:29 -0500  137) ) -> Result<String, GitAiError> {
fe2c4c8 (claude         2025-12-02 19:25:13 -0500  138)     // Resolve commits to get from/to SHAs
fe2c4c8 (claude         2025-12-02 19:25:13 -0500  139)     let (from_commit, to_commit) = match spec {
fe2c4c8 (claude         2025-12-02 19:25:13 -0500  140)         DiffSpec::TwoCommit(start, end) => {
fe2c4c8 (claude         2025-12-02 19:25:13 -0500  141)             // Resolve both commits
fe2c4c8 (claude         2025-12-02 19:25:13 -0500  142)             let from = resolve_commit(repo, &start)?;
fe2c4c8 (claude         2025-12-02 19:25:13 -0500  143)             let to = resolve_commit(repo, &end)?;
fe2c4c8 (claude         2025-12-02 19:25:13 -0500  144)             (from, to)
fe2c4c8 (claude         2025-12-02 19:25:13 -0500  145)         }

IDE 插件

在编辑器侧边栏（gutter）中显示 AI blame 标记，并按智能体会话（agent session）进行颜色编码。将鼠标悬停在某一行上，即可查看原始提示（prompt）或摘要信息。

支持的编辑器
VS Code Cursor Windsurf Antigravity Emacs magit 为其他编辑器开发了支持？欢迎提交 PR

跨智能体可观测性（Cross Agent Observability）

Git AI 从提示（prompt）到生产环境全程收集跨智能体（cross-agent）遥测数据。跟踪 AI 生成的代码有多少被接受、提交、通过代码审查并最终进入生产环境——从而帮助你识别哪些工具和实践对团队最有效。

git-ai stats --json

了解更多：Stats 命令参考文档

{
  "human_additions": 28,
  "mixed_additions": 5,
  "ai_additions": 76,
  "ai_accepted": 47,
  "total_ai_additions": 120,
  "total_ai_deletions": 34,
  "time_waiting_for_ai": 240,
  "tool_model_breakdown": {
    "claude_code/claude-sonnet-4-5-20250929": {
      "ai_additions": 76,
      "mixed_additions": 5,
      "ai_accepted": 47,
      "total_ai_additions": 120,
      "total_ai_deletions": 34,
      "time_waiting_for_ai": 240
    }
  }
}

为了实现团队级可见性，Git AI Enterprise 在 Pull Request（PR）、代码仓库（repository）和组织（organization）层面聚合数据：

• AI 代码构成 —— 跟踪整个组织中 AI 生成代码所占的百分比。
• 完整生命周期追踪 —— 查看有多少 AI 代码被接受、提交、在代码审查期间被重写，以及部署到生产环境。衡量这些代码上线后的持久性，以及是否引发告警或事故。
• 团队工作流 —— 识别哪些成员高效使用后台智能体（background agents），哪些成员并行运行多个智能体，以及哪些团队从 AI 中获得最大收益及其独特做法。
• 智能体就绪度（Agent readiness） —— 衡量智能体在你仓库中的有效性。跟踪技能（skills）、规则（rules）、MCPs（Model Calling Protocols）和 AGENTS.md 文件变更在不同仓库和任务类型中的影响。
• 智能体与模型对比 —— 按智能体和模型比较代码接受率和输出质量。

申请抢先体验

hooks/post_clone_hook.rs
  a1b2c3d4e5f6a7b8 6-8
  c9d0e1f2a3b4c5d6 16,21,25
---
{
  "schema_version": "authorship/3.0.0",
  "git_ai_version": "0.1.4",
  "base_commit_sha": "f4a8b2c...",
  "prompts": {
    "a1b2c3d4e5f6a7b8": {
      "agent_id": {
        "tool": "copilot",
        "model": "codex-5.2"
      },
      "human_author": "Alice Person <alice@example.com>",
      "messages": [],
      "total_additions": 8,
      "total_deletions": 0,
      "accepted_lines": 3,
      "overriden_lines": 0,
      "messages_url": "https://your-prompt-store.dev/cas/a1b2c3d4..."
    },
    "c9d0e1f2a3b4c5d6": {
      "agent_id": {
        "tool": "cursor",
        "model": "sonnet-4.5"
      },
      "human_author": "Jeff Coder <jeff@example.com>",
      "messages": [],
      "total_additions": 5,
      "total_deletions": 2,
      "accepted_lines": 3,
      "overriden_lines": 0,
      "messages_url": "https://your-prompt-store.dev/cas/c9d0e1f2..."
    }
  }
}

 1  pub fn post_clone_hook(
 2      parsed_args: &ParsedGitInvocation,
 3      exit_status: std::process::ExitStatus,
 4  ) -> Option<()> {
 5
 6      if !exit_status.success() {
 7          return None;
 8      }
 9
10      let target_dir =
11          extract_clone_target_directory(&parsed_args.command_args)?;
12
13      let repository =
14          find_repository_in_path(&target_dir).ok()?;
15
16      print!("Fetching authorship notes from origin");
17
18      match fetch_authorship_notes(&repository, "origin") {
19          Ok(()) => {
20              debug_log("successfully fetched");
21              print!(", done.\n");
22          }
23          Err(e) => {
24              debug_log(&format!("fetch failed: {}", e));
25              print!(", failed.\n");
26          }
27      }
28
29      Some(())
30  }

许可证

Apache 2.0

git-ai 快速上手指南

环境准备

• 操作系统：macOS、Linux、Windows（包括 WSL 和原生 PowerShell）
• 依赖：已安装 git（版本 ≥ 2.0）
• 网络：安装过程需联网下载脚本；运行时完全离线，无需登录或连接云端

注：目前官方未提供中国镜像源，若下载缓慢可尝试配置代理或使用国内加速服务。

安装步骤

macOS / Linux / Windows (WSL)

curl -sSL https://usegitai.com/install.sh | bash

Windows（非 WSL，使用 PowerShell）

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://usegitai.com/install.ps1 | iex"

安装完成后，无需在每个仓库单独配置，即可直接使用。

基本使用

1. 正常开发与提交

像往常一样编写代码并提交，git-ai 会自动记录 AI 生成的代码来源：

git commit -m "feat: add diff formatter"

提交后将显示 AI 与人工代码的比例：

you  ██░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ai
     6%             mixed   2%             92%

2. 查看 AI 责任归属（AI Blame）

使用 git-ai blame 替代 git blame，查看每行代码的生成者（人类或 AI 模型）：

git-ai blame src/log_fmt/authorship_log.rs

输出示例：

fe2c4c8 (claude [session_id] 2025-12-02 19:25:13 -0500  138)     // Resolve commits to get from/to SHAs

3. 查看 AI 使用统计

获取当前仓库中 AI 代码的使用情况：

git-ai stats

或输出 JSON 格式供程序解析：

git-ai stats --json

提示：支持的 AI 工具包括 Claude、GitHub Copilot、Cursor、Gemini 等十余种主流智能编程助手。完整列表见项目 README。