Show HN: Git why – log your agent reasoning trace along your code
a day ago
- #AI-assisted development
- #version control
- #reasoning traces
- git-why is an open protocol for storing reasoning traces alongside source code, capturing conversations and decisions shaping each line.
- It creates a .why/ directory mirroring project structure, storing plain Markdown files with entries for prompts, reasoning, and changes.
- Uses a pre-commit hook to automatically detect AI sessions and write traces without workflow changes, supporting tools like Claude Code and Cursor.
- Features include append-only format, exclusion patterns via .whyignore, union merge strategy to avoid conflicts, and provider plugin system.
- Includes CLI commands like git why show, blame, log, search, and capture for viewing and managing reasoning traces.