Compare/qmd vs Ralph

AI tool comparison

qmd vs Ralph

Which one should you ship with? Here is the side-by-side panel verdict, pricing read, reviewer split, and community vote comparison.

Q

Developer Tools

qmd

Local doc search engine with BM25 + vectors + LLM re-ranking — by Shopify's CEO

Mixed

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.

R

Developer Tools

Ralph

Autonomous loop that runs Claude Code until your whole feature list is done

Mixed

50%

Panel ship

Community

Free

Entry

Ralph is an open-source TypeScript tool that runs AI coding agents (Claude Code or Amp) in repeated cycles until every story in a Product Requirements Document is complete. Each iteration gets a fresh context window, but Ralph maintains institutional memory through git commits, a progress.txt file tracking learnings, and a prd.json tracking task status. It runs quality gates (typecheck + tests) before marking a story done and looping to the next. 15.8k stars and currently trending — it's a viral implementation of Geoffrey Huntley's 'Ralph pattern' for autonomous multi-story development.

Decision
qmd
Ralph
Panel verdict
Mixed · 2 ship / 2 skip
Mixed · 2 ship / 2 skip
Community
No community votes yet
No community votes yet
Pricing
Free, open source (MIT)
Free / Open Source
Best for
Local doc search engine with BM25 + vectors + LLM re-ranking — by Shopify's CEO
Autonomous loop that runs Claude Code until your whole feature list is done
Category
Developer Tools
Developer Tools

Reviewer scorecard

Builder
80/100 · ship

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.

80/100 · ship

The fresh-context-per-cycle approach solves the single biggest problem with AI coding agents: context exhaustion on multi-hour tasks. The prd.json format enforces the right discipline — stories small enough for one context window, outcomes defined in advance. I've shipped three features with this and it works as advertised when you write good PRDs.

Skeptic
45/100 · skip

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.

45/100 · skip

Ralph's fatal flaw is that it's only as good as your PRD, and writing a perfect PRD is harder than just coding the feature yourself. The quality gates catch compile errors but not logic bugs — you can come back to 20 commits of plausible-looking garbage that all passes typecheck. This works on toy projects, not production codebases.

Futurist
80/100 · ship

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.

45/100 · hot

15.8k stars in what appears to be weeks is a signal that the market was waiting for exactly this — a simple, composable loop over AI agents. Ralph isn't the final form, but the pattern is the future. Expect Cursor, Windsurf, and Claude Code itself to absorb this workflow natively within the year.

Creator
45/100 · skip

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.

80/100 · ship

For non-devs who can write a PRD but not code, Ralph is genuinely unlocking: describe what you want, let it run overnight, review the PR. The CLI UX is minimal but that's fine. The real experience is in the progress.txt file, which is weirdly satisfying to read — like watching an AI developer take notes.

Weekly AI Tool Verdicts

Get the next comparison in your inbox

New AI tools ship daily. We compare them before you waste an afternoon.

Bookmarks

Loading bookmarks...

No bookmarks yet

Bookmark tools to save them for later

qmd vs Ralph: Which AI Tool Should You Ship? — Ship or Skip