Qrec

qrec

Total recall for Claude Code — yours and Claude's. On-device.

qrec runs a local daemon that indexes your Claude Code sessions into a searchable database. Summaries and tags are generated by an on-device model — no API calls, no tokens spent. You browse via a web UI; Claude queries it directly during conversations via qrec search. Your full session history — including sessions Claude Code would have deleted after 30 days — stays on your machine.

• Browse without asking Claude — web UI with project filters, session summaries, and tags. Computed locally.
• Agent recall — ask Claude "What did we decide about the auth flow?" and it finds the answer from your archive, not its context window.
• Seamless handoff — when a session hits its context limit, open a new one. qrec gives Claude a clean transcript of what happened.
• Nothing gets lost — Claude Code silently clears sessions after ~30 days. qrec archives everything the moment it's indexed. Permanently.

Read the introduction post →

Prerequisites

Requirement	Details
macOS	Fully supported on Apple Silicon (tested on M2).
Linux	Supported. NVIDIA GPU strongly recommended for enrichment (tested on Tesla T4 with CUDA 12).
Windows	Not supported.
Bun	v1.1.0+ — auto-installed by the npm postinstall script if not present.
Node.js	v18+ — only needed to bootstrap the CLI wrapper; Bun handles everything else.
Disk space	~500 MB for the embedding model (embeddinggemma-300M-Q8_0, ~313 MB) + enrichment model (Qwen3-1.7B, ~1.7 GB, downloaded on first qrec enrich).

Linux CUDA note: qrec auto-detects CUDA at startup via libcuda.so / nvidia-smi. No manual configuration needed — just have the NVIDIA driver installed.

Install

Step 1 — Install the CLI

npm install -g @dvquys/qrec
qrec serve --daemon

On first run, the daemon downloads the embedding model (~313 MB) and indexes your Claude sessions. Your browser opens automatically — watch progress there.

Step 2 — Claude Code plugin (recommended)

Install the plugin to unlock in-session recall: Claude can search your past conversations in real time to answer questions about prior work.

claude plugin marketplace add dvquy13/qrec
claude plugin install qrec@qrec

Once installed, you can ask Claude things like:

• "What was I working on recently?"
• "How did we implement the auth flow last month?"
• "What did we decide about the database schema?"
• "Find that session where we debugged the rate limiter"

The plugin also ensures the qrec daemon starts automatically with every Claude Code session — no manual qrec serve needed.

Usage

The daemon runs at http://localhost:25927. Open it in your browser to search sessions and monitor indexing activity.

qrec status     # check daemon status
qrec stop       # stop the daemon

Search API

curl -s -X POST http://localhost:25927/search \
  -H "Content-Type: application/json" \
  -d '{"query": "sqlite vec extension", "k": 5}' | jq .

{
  "results": [
    {
      "session_id": "a1b2c3d4",
      "title": "...",
      "date": "2026-03-09",
      "project": "qrec",
      "score": 0.042,
      "preview": "...best matching chunk..."
    }
  ],
  "latencyMs": 58
}

CLI recall

qrec search "embedding pipeline" --k 5   # search indexed sessions (JSON output)
qrec get <session-id>                     # print full session markdown

Commands

Command	Description
qrec serve [--daemon]	Start HTTP server on port 25927; auto-downloads model + indexes on first run
qrec stop	Stop daemon
qrec teardown	Stop daemon and remove all qrec data (~/.qrec/)
qrec index [path]	Re-index sessions (default: ~/.claude/projects/)
qrec search "<query>" [--k N]	Search indexed sessions (prints JSON)
qrec get <session-id>	Print full session markdown
qrec status	Status summary + log tail
qrec enrich [--limit N]	Backfill session summaries, tags, and entities

Contributing

Contributions are welcome! See CONTRIBUTING.md for dev setup, testing, and PR guidelines.

Local dev

bun install
bun link              # register qrec globally → ~/.bun/bin/qrec
qrec serve --daemon

Stack

Layer	Choice
Runtime	Bun
Language	TypeScript
Search DB	SQLite (FTS5 + sqlite-vec)
Embeddings	node-llama-cpp (embeddinggemma-300M-Q8_0)
Enrichment	node-llama-cpp (Qwen3-1.7B)

---

If you find this work useful and want to buy me a coffee, GitHub Sponsors is the place. Thank you!