@mesadev/agentblame

Agent Blame CLI

Know what the AI wrote. Focus your code reviews where it matters.

Track AI-generated vs human-written code in your Git history. Works with Cursor, Claude Code, and OpenCode.

Prerequisites

• Bun runtime (required for hooks)
• Git 2.25+
• Cursor, Claude Code, or OpenCode

# Install Bun if you haven't already
curl -fsSL https://bun.sh/install | bash

Quick Start

1. One-Time Machine Setup

Run this once on your machine to create the local database and the ab shorthand:

bunx @mesadev/agentblame@latest setup

After setup, restart your terminal. You can now use ab instead of bunx @mesadev/agentblame@latest for all commands.

2. Repository Setup

In each git repository you want to track:

ab init

This sets up everything automatically:

• Editor hooks for Cursor, Claude Code, and OpenCode
• Git post-commit hook for attribution capture
• GitHub Actions workflow for squash/merge support

Important: Restart your editor after running ab init.

3. View Attribution

Make AI edits, commit, then view attribution:

ab blame src/auth.ts

Example output:

  src/auth.ts
  ──────────────────────────────────────────────────────────────────────
  Prompts:
  [P1] Cursor (gpt-5.2-codex)
       "Add a new file hello_world.py in python and add two print st..."
       Tools: edit: 1
  ──────────────────────────────────────────────────────────────────────
  7bdf773 Murali Varad 2026-02-03 │ P1 │ 1 │ print("Hello, World1")
  7bdf773 Murali Varad 2026-02-03 │ P1 │ 2 │ print("Hello, World2")
  ──────────────────────────────────────────────────────────────────────
  ████████████████████████████████████████
  AI: 2 lines (100%)  │  Human: 0 lines (0%)

CLI Reference

First run: bunx @mesadev/agentblame@latest setup — this creates the database and adds the ab shell alias. After restarting your terminal, use ab for all commands below.

Command	Description
bunx @mesadev/agentblame@latest setup	One-time machine setup (creates database + ab alias)
ab init	Set up hooks and GitHub Actions workflow for a repo
ab status	Show tracking stats for current repo
ab blame <file>	Show AI attribution for a file
ab sync	Transfer notes after squash/rebase
ab config	Show/set configuration
ab debug	Show detailed debug info

Configuration

# Show current config
ab config

# Disable prompt content storage (enabled by default)
ab config set storePromptContent false

How It Works

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Cursor/Claude  │────▶│   Git Hooks     │────▶│    Database     │
│   Code edits    │     │  capture edits  │     │  stores pending │
└─────────────────┘     └─────────────────┘     └─────────────────┘
                                                        │
                                                        ▼
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  CLI/Extension  │◀────│   Git Notes     │◀────│  Git Commit     │
│  show markers   │     │  store metadata │     │  triggers match │
└─────────────────┘     └─────────────────┘     └─────────────────┘

• Hooks intercept edits from AI coding tools
• Database stores pending attributions with content hashes
• Commit triggers matching of committed lines to pending edits
• Git Notes attach attribution metadata to commits
• CLI/Extension read notes to display markers

Troubleshooting

Problem	Solution
Database not found	Run bunx @mesadev/agentblame@latest setup once on your machine
Hooks not capturing	Restart your editor; run ab debug to check status
Notes not on GitHub	Run git push origin refs/notes/agentblame
Squash merge lost attribution	Ensure workflow is committed; run ab sync locally
Bun not found	Install Bun: curl -fsSL https://bun.sh/install | bash

Browser Extensions

See AI attribution directly on GitHub PRs:

• Chrome Web Store
• Firefox Add-ons

More Information

For full documentation, contributing guidelines, and source code, visit the GitHub repository.

License

Apache 2.0