git blamewas for humans.
Codeblame
is for agents + humans.

“Capture the reasoning behind every AI commit. Bridge the gap between human intent and agentic execution.”

npx codeblame init

Why Codeblame?

AI coding agents are fast, but they are often black boxes. When you run git blame, you see a commit message, but you lose the reasoning that led to the change.

Codeblame bridges this gap by capturing AI reasoning traces on every commit and saving them to a local SQLite database. It‘s zero-config, free, and stays with your repo forever.

Core Capabilities

Zero Config & Free

Stores everything in a local .codeblame/db.sqlite file. Commit it to share context with your team for free.

Premium TUI

A gorgeous interactive terminal interface built with Ink. Explore reasoning history with ease.

Agent First

Generates instructions for Cursor, Copilot, and other agents to ensure they log their reasoning traces.

Git Native

Integrated directly into your workflow via standard Git hooks.

Getting Started

  1. 01Initialize: Run codeblame init in your repo to set up the local database and hooks.
  2. 02Code: Let your AI agent (Cursor, Copilot, etc.) generate code. Codeblame tells them how to log their thoughts.
  3. 03Commit: git commit as usual. The reasoning is automatically linked to the commit ID.
  4. 04Explore: Run codeblame log to see the beautiful, interactive reasoning history.