Workspace
Turn any folder into a review workspace.
Point Retriever at a folder of PDFs, DOCX, emails, PST/MBOX archives, Slack exports, or processed productions. Files stay where they are; state lives under .retriever/ next to them.
Retriever is an open source document intelligence plugin for Claude Code. It turns local folders, productions, mailbox exports, and other supported document collections into a workspace you can search, browse, review, enrich, analyze, and export with Claude.
— Quick start
Open Claude Code and paste the commands below. Claude does the rest — no terminal, no config files.
Open Claude Code and paste this. It clones the skill into ~/.claude/skills/retriever.
!git clone --single-branch --depth 1 https://github.com/sdemyanov/retriever.git ~/.claude/skills/retriever
Paste this next. Claude runs the setup script and you're ready to go.
› !cd ~/.claude/skills/retriever && ./setup
In a new chat, tell Claude where your files live.
› Ingest this folder /path/to/your/documents
Talk to it like an assistant — no commands or syntax to learn.
› Show me document distribution by type
— Demo
From a raw folder to a citation-grounded export, in a single uninterrupted run.
— Try it yourself
Want to repeat it yourself? Here's the data. Download both the plugin and the dataset, point Retriever at it, and try the exact session from the demo.
Follow the two-step install above in Claude Code.
!git clone https://github.com/sdemyanov/retriever-data-public.git
› Ingest ./retriever-data-public and describe what is in there
— Features
Six primitives that compose into a real review workflow.
Workspace
Point Retriever at a folder of PDFs, DOCX, emails, PST/MBOX archives, Slack exports, or processed productions. Files stay where they are; state lives under .retriever/ next to them.
Natural language
Ask in plain English — no query syntax. Retriever blends keyword and metadata search, and pins every answer to the exact file, page, and Bates number so you can verify the source.
AI enrichment
Run OCR on scanned pages, translate foreign-language documents, and auto-generate image descriptions so you can search over them — all inside your workspace.
Analytics
Request summaries, distributions, timelines, and cross-field breakdowns — Retriever builds them on the fly from your collection. Ask follow-ups, filter, and explore patterns without touching a spreadsheet.
Tag & annotate
Add custom fields, review with versioned custom prompts, generate summaries, extract structured information, or bulk label selected documents as you need.
Export
Export CSVs for QC, HTML preview bundles for sharing, or zip archives with sources, previews, and a portable workspace subset — all scoped to the selection.
— Open source
Retriever is open source and runs inside Claude Code, so customization has no ceiling. Ask Claude to add a new extractor, tweak ranking, change the preview layout, wire in a custom export, or reshape any workflow — in the same terminal you already use to query your documents. Your repo, your rules, your features.