@vibe-commit/capture

The VibeCommit capture client. Records Claude Code sessions against the commits they produced.

npm install -g @vibe-commit/capture
vibecommit connect

MIT licensed. This is the client that runs on your machine. See what we upload.

Commands

| Command | What it does | |---|---| | vibecommit connect | Connect this repo and capture the current session. | | vibecommit status | Show whether capture is on for this repo and when it last succeeded. | | vibecommit off | Stop capturing for this repo. | | vibecommit why <file>:<line> | Show the conversation turns recorded against the commit that last changed this line. | | vibecommit report --since <when> | Summarise capture coverage over a time window. |

Status

Implemented, not a scaffold. All five commands above have real bodies — OAuth sign-in and credential storage, git inspection, redaction, and the Claude Code hook contract — backed by an extensive test suite. Beyond the five interactive commands, this binary also answers a hidden hook invocation (dispatched outside --help, since no one types it) for Claude Code's Stop, PreCompact, and SessionEnd events; that hook mode is what Vibe-Commit/claude-plugin vendors and wires up by default when you install the Claude Code plugin instead of this package directly.

What is established, and what future changes must not undo:

• All user-facing copy lives in src/copy/. No command body contains an inline user-facing string literal. A claims gate can only check copy it can find.
• One commit-header renderer, in src/copy/grades.ts, which takes the edge grade. Evidence qualifiers are adjacent to the claim by construction rather than by review.
• The exit-code contract is split (src/exit.ts): hook invocations always exit 0 and stay silent; interactive verbs get normal CLI semantics.

Development

npm install
npm test          # node --test --import tsx
npm run typecheck
npm run build

Node >= 22.15.0.

License

MIT — see LICENSE.