@mesadev/agentblame

Agent Blame

Track AI-generated vs human-written code. Know what the AI wrote and focus your code reviews where it matters.

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

Installation

Use with bunx (recommended):

bunx @mesadev/agentblame@latest <command>

Or install globally:

npm install -g @mesadev/agentblame

Setup

1. One-Time Machine Setup

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

bunx @mesadev/agentblame@latest setup

2. Repository Setup

In each git repository you want to track:

bunx @mesadev/agentblame@latest init

This sets up:

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

Note: Restart your editor after running init.

Usage

• Make AI edits in Cursor, Claude Code, or OpenCode
• Commit your changes (attribution attached automatically)

git commit -m "new python file"

┌──────────────────────────────────────────────────────────────────────┐
│                            Agent Blame v3                            │
├──────────────────────────────────────────────────────────────────────┤
│  Commit: 7bdf773b                                                    │
│  Files: 1                                                            │
├──────────────────────────────────────────────────────────────────────┤
│  Sessions:                                                           │
│    b4deb96e [cursor - gpt-5.2-codex]                                 │
│      [P13] "Add a new file hello_world.py in python and a..."        │
├──────────────────────────────────────────────────────────────────────┤
│  Summary:                                                            │
│  ██████████████████████████████████████████████████                  │
│  AI:   2 lines (100%)    Human:   0 lines (  0%)                     │
└──────────────────────────────────────────────────────────────────────┘ 

• View attribution:

agentblame blame <file>

Example Output

  python/hello_world.py
  ──────────────────────────────────────────────────────────────────────
  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 Commands

agentblame setup             # One-time machine setup (creates ~/.agentblame database)
agentblame init              # Set up hooks and workflow for current repo
agentblame clean             # Remove hooks from current repo
agentblame blame <file>      # Show AI attribution
agentblame sync              # Transfer notes after squash/rebase
agentblame config            # Show/set configuration
agentblame debug             # Show detailed debug info

Examples

bunx @mesadev/agentblame@latest setup
bunx @mesadev/agentblame@latest init
bunx @mesadev/agentblame@latest blame src/index.ts
bunx @mesadev/agentblame@latest config set storePromptContent true

Chrome Extension

See AI markers on GitHub PRs with our Chrome extension.

Get it from the Chrome Web Store or the GitHub repository.

Troubleshooting

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

More Information

For full documentation, Chrome extension installation, and contributing guidelines, visit the GitHub repository.

License

Apache 2.0