AI tool comparison
git-why vs qmd
Which one should you ship with? Here is the side-by-side panel verdict, pricing read, reviewer split, and community vote comparison.
Developer Tools
git-why
Persist AI agent reasoning traces alongside your code in git history
75%
Panel ship
—
Community
Free
Entry
git-why is an open-source tool that captures and stores the reasoning trace from AI coding agents — the planning, consideration, and decision-making behind code changes — as structured metadata alongside your git commits. Its premise: when you use Claude Code or another AI agent to write code, you produce two artifacts. The code survives in git. The reasoning doesn't. git-why fixes that. The workflow integrates into your existing git hooks. When you commit, git-why serializes the agent's reasoning trace (captured via hooks into Claude Code, Cursor, or Amp) and stores it as a lightweight sidecar file in your repo or a companion metadata store. Future developers (or future you) can run git why <commit-hash> to see not just what changed, but why the AI made the architectural decisions it did — which alternatives it considered, which constraints it was responding to, and what it was uncertain about. The project showed up on Hacker News today and generated thoughtful discussion about AI-assisted development archaeology — the question of how future teams will understand codebases built by AI agents. git-why is the earliest serious attempt at answering that question.
Developer Tools
qmd
Local doc search engine with BM25 + vectors + LLM re-ranking — by Shopify's CEO
50%
Panel ship
—
Community
Free
Entry
qmd is a lightweight local search engine built by Tobi Luetke, CEO of Shopify, for indexing and querying personal knowledge bases, documentation, and meeting notes — entirely offline. It combines three retrieval approaches in a single pipeline: BM25 full-text search for exact keyword matches, vector semantic search via ONNX-based embeddings, and LLM re-ranking using GGUF models through node-llama-cpp. All three stages run locally with no cloud dependency. The tool ships in multiple deployment modes: a CLI for ad-hoc queries, a Node.js library for programmatic use, an HTTP service for local API access, and — most useful for AI workflows — a native MCP server that lets Claude Code, Cursor, and similar editors query your local knowledge base directly during coding sessions. The hybrid retrieval approach means it handles both "find the exact error message from last week's standup notes" and "what was our decision about the auth architecture" equally well. What makes this notable beyond its technical approach is provenance: Luetke shipped it as a personal tool he actually uses, not a startup product. The GitHub history shows active iteration and he's been talking about it on X. It's a credible signal of where pragmatic AI-augmented knowledge management is heading for technical users who prefer local-first tools.
Reviewer scorecard
“The commit message has always been inadequate documentation and AI-generated code makes this worse, not better. git-why is the first tool I've seen that treats agent reasoning as a first-class artifact of the development process. This is especially valuable for onboarding — imagine joining a codebase and being able to ask 'why does this function exist?' and getting the actual AI's reasoning chain.”
“Hybrid BM25 + vector + LLM re-rank is the right architecture for personal knowledge search — each layer catches what the others miss. The MCP server mode is genuinely useful: being able to ask Claude Code 'what did we decide about X last month' against my own notes changes the workflow. MIT licensed and from someone who ships real products.”
“The reasoning traces captured by AI agents are often verbose, self-referential, and not actually representative of the true 'why' behind a decision — they're post-hoc justifications as much as genuine reasoning. git-why could end up storing a lot of confident-sounding noise that misleads future developers. Also, the repo size implications of storing detailed traces for every commit need serious consideration.”
“This is a well-executed weekend project, not a production tool. It requires GGUF models and manual embedding setup — a meaningful friction barrier for non-technical users. The 'built by a CEO' narrative drives GitHub stars more than the technical differentiation. Obsidian with a local AI plugin gets you here with better UX.”
“As AI writes an increasing fraction of production code, the question of 'why does this codebase look this way' becomes critically important for maintenance, auditing, and regulatory compliance. git-why is early and rough, but it's pointing at something that will eventually become mandatory for AI-generated code in regulated industries.”
“The pattern here — local hybrid retrieval as an MCP server feeding into AI coding agents — will be ubiquitous in two years. Today it's a technical power-user tool; tomorrow it's how everyone's AI assistant knows the institutional context behind the code. qmd is an early, clean implementation of that pattern.”
“The concept translates beautifully to creative work — imagine version control for design decisions with the AI's reasoning about why it chose this color palette or layout attached. git-why for Figma would be genuinely revolutionary. The core insight here is timeless: preserve the intent, not just the artifact.”
“I manage a lot of notes, references, and creative briefs, but the setup friction here — GGUF models, CLI configuration — makes this inaccessible for most creators. The concept is great; the UX needs a front-end before it reaches beyond developers.”
Weekly AI Tool Verdicts
Get the next comparison in your inbox
New AI tools ship daily. We compare them before you waste an afternoon.