Confess

Confess: Git pre-push gate tool that pauses pushes for AI-assisted commits to capture human explanations in a repository log.

Confess is a local Git pre-push gate designed for AI-assisted work. When a commit carries markers such as Co-Authored-By from tools like Claude, Copilot, Cursor, Codex, or Aider, the push pauses until the user answers three questions about what the code does, how it might break, and how to verify it. The answers and any skips are appended to a CONFESSIONS.md file in the repository so the trace travels with the code. It uses pure Python with zero runtime dependencies and includes an optional MCP server for agents. The tool never calls an LLM, never amends history, and never scores answers, relying instead on human-signed traces.

Confess at a glance

Best for: Software engineer
Runs on: CLI, open source
Pricing: Free
Released: October 2026
Category: AI productivity tool
Website: github.com/yesterdayfuture/confess

Key features

Local Git pre-push hook
Append-only CONFESSIONS.md log
Optional MCP server for AI agents
Commit marker detection for AI authorship
Editor integration for answering questions
Skip mechanism for hotfixes with audit trail

Use it for

Recording human explanations for AI-generated code
Maintaining an audit trail for incident reviews
Documenting changes during team onboarding
Enforcing local review habits before pushing

Alternatives to Confess

Claudian — Turns an Obsidian vault into a functional directory for AI agents.
Git To Big Mac Hedger — It uses objective git stats instead of subjective work hours to calculate rewards.
SealKeeper — Verifiable trustworthiness
SupaYatta — Tracks Claude Code, Cowork, and Codex sessions in the Mac notch with instant alerts.
Stacks — Learn how top engineers use coding agents and review AI code.
Kaiku — Wire-level MCP compatibility lets existing AI agents work without custom bridges.
Nuvrail — Stages every AI agent email write and send for human sign-off before reaching the mail server.
GitHub Stars Manager — Local-first repository organization with AI-powered search and release tracking.
Projecttodo — Keeps your projects and AI workflows on your own machine with a built-in MCP server.
IWE — Works natively across Mac apps, text editors, terminal CLI, and MCP servers.
SwarmVault — Compiles raw sources into a local-first knowledge graph without requiring cloud access.
Quello — Ask across Notion, GitHub, Google Drive, and PDFs with exact-source citations.

All Confess alternatives