dkod — Claude Code plugin
Git-native flight recorder for AI coding agents. This plugin wires dkod into Claude Code so every session is captured into your repo's own git refs (refs/dkod/sessions/*) — no external service, no SaaS database. Blame any line back to the prompt that produced it. Flag intent-vs-output drift.
Privacy: Transcripts are never stored outside your git host.
What it does
- Automatic capture — hooks on every Claude Code lifecycle event (
SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, PostToolUseFailure, PreCompact, Stop, SessionEnd) stream the session into refs/dkod/sessions/<id> in the current repo.
- Fail-open by design — if the
dkod binary is missing or misbehaves, every hook still exits 0 and your session is never blocked.
- Slash commands for the dkod CLI:
/dkod:init — initialize capture in the current repo (dkod init)/dkod:log — list captured sessions (dkod log)/dkod:blame <path> — trace lines back to the session/prompt that wrote them (dkod blame)/dkod:drift — flag intent-vs-output drift (dkod drift)
Requirements
The dkod CLI (v0.2.0+) must be installed:
brew install dkod-io/tap/dkod
or:
curl -fsSL https://raw.githubusercontent.com/dkod-io/dkod-cli/main/install.sh | sh
Install the plugin
From this repo's marketplace:
/plugin marketplace add dkod-io/claude-plugin
/plugin install dkod@dkod
Or load directly from a local clone for development:
git clone https://github.com/dkod-io/claude-plugin
claude --plugin-dir ./claude-plugin
Then run /dkod:init in any repo you want captured.
How capture works
Each hook runs:
command -v dkod >/dev/null 2>&1 && dkod capture-hook --agent claude-code --event <Event> || true
dkod capture-hook buffers the hook event and exits 0 on misuse by design; the command -v guard and || true make the hook a no-op when dkod isn't installed or a stale binary errors — your session is never interrupted (see dkod-io/dkod-cli#24).
Privacy
Transcripts are never stored outside your git host. Sessions live as ordinary git objects under refs/dkod/sessions/* in your repository — you control where they go, who reads them, and when they're deleted, exactly like any other ref.
License
MIT
