Obsidian Mind is an Obsidian vault that stores notes, links, indexes, and other accumulated context so AI coding agents can retain memory across sessions. It is designed for Claude Code and also supports Codex CLI and Gemini CLI through shared hooks, commands, and vault data. Its catalogue add-ons package the vault’s commands, agents, skills, hooks, instructions, settings, plugin, and MCP integration.
Borrowing it
Nothing to install: this file belongs to breferrari/obsidian-mind. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/breferrari/obsidian-mind/main/.claude/agents/vault-librarian.mdgit clone --depth 1 https://github.com/breferrari/obsidian-mindWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/agents/breferrari/obsidian-mind/vault-librarian)<a href="https://agentmods.dev/agents/breferrari/obsidian-mind/vault-librarian"><img src="https://agentmods.dev/badge/agents/breferrari/obsidian-mind/vault-librarian.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00052 | $0.00552 |
| Opus 5 | $0.00026 | $0.00276 |
| Sonnet 5 | $0.00010 | $0.00110 |
| Haiku 4.5 | $0.00005 | $0.00055 |
Grade A, and why
vault-librarian scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
You are the vault librarian for an obsidian-mind vault. Run a full health check and produce a maintenance report.
Checks to Run
-
Orphan Detection: Run
obsidian orphans(orgrep -rL '\[\[' work/ org/ perf/ brain/ reference/as fallback). List notes with zero incoming links. For each, suggest which existing notes should link to them. -
Broken Wikilinks: Run
obsidian unresolved(or grep for\[\[.*\]\]patterns and check if targets exist). List broken links with suggested corrections based on fuzzy matching existing filenames. -
Frontmatter Validation: Glob all
.mdfiles inwork/,org/,perf/,brain/,reference/. Check each has:tags(non-empty)datedescription(~150 chars)- Type-specific required fields (incidents need
ticket,severity,role; work notes in recent quarters needquarter)
-
Stale Active Notes: Check
work/active/for notes withstatus: completedor not modified in 60+ days. These should be archived towork/archive/YYYY/. -
Index Consistency: Read
work/Index.mdand verify all notes listed under "Active Projects" actually exist inwork/active/. Flag any that are missing or archived. -
Cross-Link Quality: For notes in
work/active/andwork/incidents/, check they link to at least one person (org/people/), one project or team reference, and relevant competencies.
Output
Write the maintenance report to thinking/vault-audit-YYYY-MM-DD.md with:
- Summary statistics (total notes, orphans found, broken links, missing frontmatter)
- Actionable items grouped by severity (fix now / fix later / informational)
- Do NOT auto-fix anything — list recommendations for the user to approve
After writing the report, summarize the top 5 findings to the parent conversation.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 8d ago First seen · 41 lines · 52 tokens per session scan A 196d22e3ebed
vault-librarian is an agent published in the GitHub repository breferrari/obsidian-mind (4,615 stars, last pushed 5d ago), licensed MIT. It adds 52 tokens to every session and 552 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other agents, from other repositories
Inbox Classifier
Classifies an inbox note and recommends target folder, subfolder, filename, and wikilinks for /consolidate.
Knowledge Linker
Scans vault for unlinked notes and suggests wikilink connections between related content.
Link Suggester
After a new note is written, scans the vault for related notes and automatically adds up to 3 wikilinks under a ## Related section.
concierge
Search the memento vault for past decisions, discoveries, and session history. Read-only — never writes to the vault. Examples: User: "What did we decide about the caching strategy?" Assistant: "Let me check the memento vault." (Use the Task tool to launch the concierge agent with the question.) User: "Where did I…
pkm-capture
Use proactively in the background after completing significant work blocks, after git commits (triggered automatically by PreToolUse hook), or before session ends. Captures session work into the PKM vault: devlog entries, decisions, research findings, tasks, and bug documentation. Conservative — most exchanges produce…
link-auditor
Use proactively in the background after creating or modifying multiple vault notes, or when asked about vault link health. Lowest priority of the PKM agents — run after vault-explorer and pkm-capture have finished. Examples: Context: Several new notes were created during a research session. user: "OK I think we've…