punt-labs/quarry

> Local semantic search for AI agents and humans.
Quarry indexes documents in 20+ formats, embeds them with a local ONNX model (snowflake-arctic-embed-m-v1.5), stores the vectors in LanceDB, and serves semantic search to Claude Code, Claude Desktop, and the command line. Everything runs locally — no API keys, no cloud accounts. One quarryd daemon per machine loads the model once; the CLI, the MCP server, and the Claude Code hooks are thin clients over it, reachable directly too via an HTTP API.
Platforms: macOS (Apple Silicon), Linux
## Quick Start
Install the CLI, the daemon, the MCP server, and the Claude Code plugin:
bash
curl -fsSL https://raw.githubusercontent.com/punt-labs/quarry/beb3fa9/install.sh | sh
Restart Claude Code. Your current project is auto-indexed at session start, so you can search it by meaning right away — see What It Looks Like.
Manual install (if you already have uv)
Install the package:
bash
uv tool install punt-quarry
Set up the daemon, TLS certificates, and MCP config:
bash
quarry install
Check health:
bash
quarry doctor
Homebrew (Apple Silicon macOS, Linux)
Intel macOS is not currently supported by any install path — two of quarry's dependencies (lancedb, onnxruntime) publish no Intel macOS wheel, so uv tool install/pip install fails there the same way brew install does.
brew install puts the quarry, quarryd, and quarry-hook binaries on PATH. Run quarry install afterward for the model download, TLS certificates, and daemon service:
bash
brew install punt-labs/tap/quarry
quarry install
To add the Claude Code plugin too:
bash
claude plugin marketplace add punt-labs/claude-plugins
claude plugin install quarry@punt-labs
Use one distribution channel per machine — mixing Homebrew with the curl | sh installer puts two copies of quarry on PATH in different locations, and whichever comes first wins. Run which quarry (or command -v quarry) to see which one that is.
CLI only (skip the Claude Code plugin)
For non-Claude harnesses (Codex, Cursor, a plain terminal) or Claude Code users whose org policy blocks marketplace/plugin installs, --no-plugin installs everything except the marketplace-register and plugin-install steps:
bash
curl -fsSL https://raw.githubusercontent.com/punt-labs/quarry/beb3fa9/install.sh | sh -s -- --no-plugin
Where a flag cannot be passed (CI templating a bare curl … | sh), set QUARRY_NO_PLUGIN=1 — honored only when exactly 1:
bash
curl -fsSL https://raw.githubusercontent.com/punt-labs/quarry/beb3fa9/install.sh | QUARRY_NO_PLUGIN=1 sh
Everything else runs unchanged. Use the CLI and the stdio quarry mcp server directly; both talk to the resident quarryd. Re-run the installer without --no-plugin to add the plugin later.
Verify before running
Download the installer:
bash
curl -fsSL https://raw.githubusercontent.com/punt-labs/quarry/beb3fa9/install.sh -o install.sh
Check its digest (shasum -a 256 install.sh on macOS):
bash
sha256sum install.sh
Read it:
bash
cat install.sh
Run it:
bash
sh install.sh
## Features
20+ formats — PDFs (with OCR for scanned pages), source code (AST-aware splitting), spreadsheets, presentations, HTML, Markdown, LaTeX, DOCX, images.
Semantic search — retrieval is by meaning, not keyword. A query about "margins" finds passages about profitability even if they never use that word.