mrkeyoor.com_
Wed 12 Aug 16:49 UTC
Dev Toolsevaluationupdated 12 Aug 2026

git-ai

Git AI is a local Git extension that records which lines were written by a supported coding agent, along with the agent, model, session, and prompt behind them. It gives teams an AI-aware version of blame and commit statistics without trying to guess authorship from the finished code.

Verdict

Git AI is the most convincing open approach to AI code provenance because it records explicit agent checkpoints instead of pretending finished code reveals its author. Its local mode, Git Notes format, blame replacement, and rewrite support make the idea useful today. Treat the numbers as operational evidence rather than an audit oracle until the human-boundary, rewrite, memory, and push-latency defects are proven fixed in your workflow.

Setup4/5One installer and no repo init, but hooks and a daemon remain
Docs5/5Clear internals, privacy rules, commands, CI, and limitations
Community4/5Very active releases and fixes, with a large open queue
Maturity3/5Broad workflow support, but attribution and resource bugs matter

Who it’s for

Developers using supported agents such as Claude Code, Codex, Cursor, Copilot, OpenCode, or Gemini who want line-level provenance.
Engineering teams measuring accepted AI output, human rewrites, model use, and token cost across commits.
Reviewers who need to move from a suspicious line back to the agent session and prompt that produced it.
Organizations willing to deploy CI actions or the team product to preserve notes through server-side squash and rebase merges.
Tool builders interested in an open Git Notes standard for explicit AI attribution.

Who it’s NOT for

Compliance teams that require attribution to be infallible: an open report shows human edits being absorbed into an AI checkpoint when no later agent hook closes the boundary.
Heavy Graphite users unwilling to test rewrite behavior: current reports cover stranded checkpoints, dozens of failing workflow scenarios, and multi-gigabyte memory use during move and restack operations.
Developers who cannot risk Git pushes pausing on provenance work: an open v1.6.20 report says note reconciliation blocked pushes for minutes until the daemon was killed.
Repositories that depend on git mv, git filter-repo, git filter-branch, or git replace preserving attribution: the README marks those operations unsupported.
Teams expecting attribution from any AI tool automatically: agents must emit checkpoints or have a supported integration, and an open request is still needed for Qoder.
Windows or managed-desktop rollouts that require settled native installers: the latest release labels Windows MSI and macOS PKG packages beta.

Setup reality

The personal path is short but not invisible: run the installer, let it place the binary under the user account, modify shell paths, install IDE or agent hooks, and keep its background daemon healthy. There is no per-repository initialization and normal commits stay normal. Reliable team use takes more work because Git Notes must be synchronized, server-side squash or rebase merges need CI actions or the team service, prompt and telemetry policy must be configured, and rewrite-heavy workflows deserve their own attribution tests.

Provenance reported by the agent, not guessed later

Git AI addresses a problem that ordinary Git cannot represent. A commit records the human committer, but a modern change may combine work from several coding agents, prompts, models, and manual edits. Git AI adds a line-level attribution layer, so git ai blame can show an agent beside the lines it generated and git ai stats can summarize AI additions, accepted lines, human overrides, tools, models, tokens, and costs.

Its key design decision is correct: it does not inspect finished code and guess whether AI wrote it. Supported agents call git-ai checkpoint when they change files. On commit, the extension maps those checkpoints to lines and writes authorship metadata into Git Notes. Prompt text stays outside Git in a local SQLite database. That is more defensible than a classifier, and the published version 3 standard gives other tools a format to implement.

The result can answer useful review questions. A maintainer can trace a questionable line to the tool call and prompt that produced it. A team can compare generated lines with accepted lines rather than treating every suggestion as delivered value. Git AI also records sessions that produced no committed code, helping distinguish agent activity from durable output.

The personal install is easier than the internals

The macOS, Linux, and WSL path is a curl installer; Windows gets a PowerShell installer. Release assets cover x64 and ARM64, checksums are supported, and the project documents GitHub attestation verification. The installer puts the binary in a per-user directory, adds it to shell paths, and installs supported IDE or agent hooks. Running as root is discouraged because ownership can cause persistent daemon lock failures. Native Windows MSI and macOS PKG installers are still marked beta.

There is no per-repository setup and no Git hook or Git binary wrapper on the hot path. Git AI uses a background daemon and Git tracing, then reconciles attribution eventually. Developers continue to commit from the CLI, an IDE, or another Git client. The README says the daemon checks and updates agent hooks daily, and git ai install-hooks can refresh them manually.

That setup is pleasantly small for an individual. Organization-wide accuracy is not one command. Git Notes must travel with the repository, while server-side squash and rebase merges require the open CI actions or the team product. Multi-repository agent runs need each Bash command’s working directory inside the affected repository. Teams should verify aliases, worktrees, desktop clients, Graphite, and hosting merge policies before trusting aggregate numbers.

Privacy is good locally and different in cloud mode

Open-source mode requires no account and works offline. The privacy document says code, prompts, and agent usage data are not sent to Git AI when the user does not log in. Prompts remain on the laptop, while the repository’s Git Notes contain the agent, model, accepted-rate data, attributed lines, and the steering developer’s Git identity. Error and exception telemetry is enabled by default, but configuration can disable or redirect it.

The cloud and team products collect much more. A personal dashboard can upload tool use, MCP calls, skills, interruptions, errors, tokens, prompts, and responses. Team deployments can store employee identity, full prompts after best-effort secret and personal-data stripping, full sessions, and source-control metadata. Self-hosting keeps that data in the organization’s instance. Buyers need to evaluate these modes separately; the local CLI’s privacy properties do not automatically describe the hosted dashboard.

Git rewrites are the hard and valuable part

Basic attribution would be easy if commits never changed. Git AI attempts to carry notes through rebase, cherry-pick, stash, squash merges, resets, amend, branch switching, pulls, pushes, and worktrees. This is the feature that makes the project more than a commit-message convention. Formatters are supposed to preserve AI attribution rather than convert every reformatted line to human work.

The limitation table is refreshingly specific. File renames through git mv do not preserve attribution. Bulk rewrites with git filter-branch or git filter-repo, plus git replace, are unsupported. Server-side hosting operations need extra support. These are acceptable boundaries if teams know them, but they exclude common repository maintenance and migration jobs from any promise of an unbroken record.

More concerning are open correctness defects within supported-looking workflows. Issue 2067 demonstrates human text being attributed to Claude when no subsequent agent hook closes a checkpoint boundary. Issue 2103 reports three Graphite branch-movement patterns that strand uncommitted checkpoints, producing empty notes and human blame for AI lines across roughly 54 failing scenarios. For a provenance product, false authorship is the central failure mode, not a minor edge case.

Active development is fixing serious operational pain

The repository was pushed on August 12, 2026, and version 1.6.22 arrived two days earlier. Six stable versions from 1.6.17 through 1.6.22 shipped between July 29 and August 10, alongside preview builds. GitHub metadata listed 171 open issues and pull requests; separate search showed 61 issues and 108 pull requests. Nightly agent integration failures were filed on August 11 and 12, showing active compatibility monitoring as agent CLIs change.

That velocity is reassuring, but it also reflects a demanding system. An open report against 1.6.20 describes a Graphite rewrite path spawning Git work that consumed about 15 GB in one production case. Another says push-time notes reconciliation blocked Git pushes for minutes. Version 1.6.22 adds daemon memory-limit controls and a lighter note-rewrite mode, but its release notes do not claim that every reported rewrite or push path is resolved. Test the latest version rather than assuming a nearby fix covers the same mechanism.

Git AI is worth installing for developers who want to inspect their own agent use, and worth piloting for teams that need evidence about adoption and rework. The open standard and local-first architecture are strong foundations. The responsible rollout is to compare attribution with known test edits, exercise real rewrite and merge paths, set resource limits, and document privacy mode. When those checks pass, its data is far more useful than a vague “AI-assisted” commit trailer.

Alternatives

ProjectWhat it isPick it when
AiderA terminal coding assistant with a Git-centered workflow and automatic commits for its changes.pick this instead when one agent's commit history is enough provenance and you want the coding assistant included.
PlandexA terminal AI development tool that stages proposed changes for review before applying them.pick this instead when isolating and reviewing AI changes before they enter Git matters more than tracking many agents after the fact.
OpenHandsA self-hostable software-development agent with inspectable sessions and workspace changes.pick this instead when you want to standardize on one controllable agent environment rather than add provenance across existing tools.

What people are saying

  1. [github-trending] git-ai-project/git-ai

Sources

  1. Git AI GitHub repository
  2. Git AI standard version 3
  3. Git AI data privacy documentation
  4. Git AI v1.6.22 release
  5. Human edits attributed to AI issue
  6. Graphite checkpoint displacement issue
  7. Graphite memory growth issue
  8. Push-time note reconciliation issue