commonplace

Reviewed at commit 41e3373 New version, not yet reviewed

Caution: Copies prompts you type, connector (MCP) results and pages Claude fetches into your vault's .wiki folder for up to 30 days when they match notes, from any project.

Sends data to arXiv (arxiv.org, export.arxiv.org), Semantic Scholar (api.semanticscholar.org), GitHub search (api.github.com)

An LLM-maintained knowledge base for Obsidian vaults that triggers on paper sharing and research questions.

Made by
noopz
What we checked

Indexes a folder of notes, gives Claude vault search tools, adds a pointer under answers when a note connects, and keeps private folders sealed from file and Bash calls. By default it also revises notes with model calls on your account and commits them to the vault's git, storing prompts, connector results and fetched pages that bear on notes. Paper skills query arXiv, Semantic Scholar and GitHub.

Review details

Static review of the source at the pinned commit; not run. Full re-review (the diff since 6b6e778 is 725k chars). Read fully: plugin.json (userConfig switches), package.json, hooks/hooks.json, hooks/register.tsx (complete in the bundle this time), bin/commonplace, scripts/session-check.ts, scripts/lib/git-unit.ts, scripts/lib/revision/capture.ts and artifact.ts, hooks/lib/revision/capture-gate.ts and the capture case of scripts/revise.ts; the other hooks/lib modules, scripts and the prompts file were checked by targeted search for network calls, hosts, process spawning, git, file writes, deletes, env vars, home paths, settings and allowed-tools. Shell hook (SessionStart): only `commonplace session-check`, which counts sessions in <plugin>/.runtime and prints a systemMessage if the module has not loaded; the npm install, esbuild build and cache cleanup of the previous version are gone (Claude Code installs pdfjs-dist from the lockfile). Module hooks: session.start (registers mcp__commonplace__vault_* tools and /vault, pins each vault's git branch in $.store, fetches the public pricing page from platform.claude.com weekly for its daily budget, rotates <vault>/.wiki/hook-log.jsonl, asks via $.ui.ask before trusting skills from <vault>/.claude/skills), session.end (flushes revision work, commits ledgers), tool.call on Read/Grep/Glob/Bash/Write/Edit/NotebookEdit (denies paths into sealed private folders and capture/ledger artefacts, denies writes that reproduce private note titles, strips remote image embeds and long URLs from source-note writes; fails open), tool.call Bash (denies JSON one-liners over vault files, hand-run plugin scripts and chained commits; runs `commonplace commit`/`revise` itself with $.process.run and returns the output; prefixes COMMONPLACE_OPEN for other commonplace commands), tool.call Write/Edit (git hash-object -w of the old blob, patches the index, runs `commonplace post-write`), tool.call Read (revision status as context), tool.call WebFetch and every mcp__ tool except its own and browser/Claude Docs tools (read capture), agent.spawn (rewrites vault-research subagent prompts after $.model.classify), tool.describe, skill.prompt, prompt.context, prompt.submit (band, typed-prompt capture, optional prime lane off by default), turn.start, ui.render (AbovePrompt band with buttons, ToolUse row, Spinner, AssistantMessage links and citation flags, activity/witness/quarantine/explain panes) and turn.complete (classify plus one Haiku completion, appends a pointer line to the answer and a user message via $.session.append; optional link triage via $.model.fork, off by default). Vault revision (vaultRevision, on): background jobs call $.model.complete under a dailyBudgetUSD cap (default 5 USD), fetch source URLs named in notes (any host, GET only, cached in .wiki/revision/artifacts) and commit accepted edges to the vault's git with commit-tree/update-ref in a temporary index, only on the branch pinned at session start and never sweeping in the owner's uncommitted edits; Undo reverts. Read capture (readCapture, on): typed prompts of 120+ characters, MCP tool results of 300+ characters from read-type tools and URLs Claude fetched (re-fetched by the CLI unless they carry token-like parameters) are matched against the vault index for free; on a match the full text (up to 200,000 characters) is stored in <vault>/.wiki/revision/captures/ for up to 30 days and sent to the model in revision jobs. This works from any project once a vault is registered; plugin.json describes the feature but says nothing is written until a revision is accepted, and the README does not mention it. Runtime calls: $.process.run (node bin/commonplace, git, cat, tee, find, ls, mkdir, tail, wc, grep, test), $.fs.read/write/stat, $.store, $.state, $.model.classify/complete/fork, $.http.fetch (pricing page only), $.tool.register, $.command.register, $.ui.toast/status/ask/open/resolve, $.session.*, $.prompt.submit (only on Ingest/Read button presses). CLI scripts run by skills with normal permission fetch PDFs from arxiv.org or a given URL and send arXiv ids and titles to export.arxiv.org, api.semanticscholar.org and api.github.com. Agent and skill prompts tell Claude to commit with `commonplace commit`; no allowed-tools pre-approvals, no eval, no credential reads; it reads the vault registry under ~/.claude/plugins/data/commonplace-*. Not reviewed: pdfjs-dist.

What it uses
  • Reads your prompts: yes
  • Sees tool calls: yes
  • Blocks or changes tool calls: yes
  • Reads or writes files: yes
  • Runs programs on your machine: yes
  • Calls the model (uses tokens): yes
  • Sends data over the network: yes
  • Stores data: yes
  • Shows something on screen: yes

LLM-maintained knowledge base for Obsidian vaults. Auto-triggers on paper sharing, vault health queries, concept compilation, research questions, and domain management.

Made this mod? Add a badge to your README

modsforClaude badge for commonplace

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/commonplace.svg)](https://modsforclaude.com/mods/commonplace/)

← All mods