claude-paperloom
githubClaude Code Plugin for Self-maintaining research knowledge graph for Claude Code + Obsidian
Stars
⭐ 85
License
Apache-2.0
Last Updated
2026-05-16
Source
github
A Claude Code Plugin for Self-maintaining research knowledge graph for Claude Code + Obsidian.
|
|
| Knowledge graph view — 🟡 papers · 🟢 findings · 🟣 fields · 🔴 authors. Example shown: Typhoon.AI research papers. | Per-paper info page — 4-section summary (incl. critique), atomic findings, metadata + quality scores, and typed edges to related work. |
Keep every paper you care about. See how they connect. Drop in a URL, arXiv ID, DOI, or PDF — Claude files it into an Obsidian vault, extracts the atomic claims, and wires them to everything you’ve read before with typed edges: supports, contradicts, extends, uses, similar-to.
Based on Andrej Karpathy’s LLM Wiki pattern, tuned for research papers. 4 LLM calls per paper. Zero manual filing. Linking cost stays constant as the graph grows.
Features
- 4-section triage summary per paper — Key Takeaways → Background → Main Idea & Summary → Critique. The critique is generated by a reasoning model, so you get critical thinking, not a polite restatement of the abstract.
- Structured metadata + quality scores — authors, venue, date, fields, and a quality assessment (credibility, experimental rigor, reproducibility) on every paper.
- Atomic findings as graph nodes — one claim per file, with frontmatter and backlinks.
- Typed edges —
supports,contradicts,extends,uses,similar-to; auto-aggregated to paper-level (cites,builds-on, …). - Deterministic citation matching — arXiv ID → DOI → fuzzy title → first-author+year. The LLM never sees the reference list.
- Constant-cost linking — pre-filter caps the LLM at ≤30 candidate findings, so the 100th paper costs the same as the 10th.
- Cross-paper contradiction surfacing — bidirectional, with a pre-built Dataview view.
- Pre-built Dataview views — by-author, by-field, contradictions, high-credibility, recent-papers.
- Obsidian-native — plain wikilinks + YAML frontmatter, no custom app, no lock-in.
Quick Start
# 1. Install the plugin
claude --plugin-dir /path/to/claude-paperloom
# 2. Scaffold your vault (default ~/PaperLoom)
# On first run, this creates `.venv` at the plugin root and installs
# dependencies from `requirements.txt` automatically.
/paperloom:init
# 3. Ingest your first paper
/paperloom:ingest https://arxiv.org/abs/1706.03762
Open the vault folder in Obsidian and turn off Restricted Mode once to activate Dataview.
Commands
| You run | Claude does |
|---|---|
/paperloom:init [path] | Scaffold the vault. Idempotent. Seeds Dataview. |
/paperloom:ingest <url|arxiv-id|doi|pdf> | Fetch, summarize, extract findings, link. Skips if already in vault. |
/paperloom:query <question> | Search + synthesize across the vault with wikilink citations. |
/paperloom:lint | Health check. Auto-wires near-duplicate findings with bidirectional similar-to. |
Docs
- Pipeline — the 4-LLM-call ingest pipeline, section detection, models, token cost.
- Linking — five-layer linking, relation types, paper-level aggregation.
- Architecture — vault layout, plugin structure, design principles, out-of-scope.