vault-migrator

vault-migrator is an agent for Claude Code from superuser-pal/awesome-second-brain. It costs 53 tokens per session (5,000 once invoked), scanned A, original, MIT.

A tool for moving notes from one Obsidian vault—a folder of linked Markdown files—to another. It first classifies the source files and can then apply an approved migration plan.

In plain words
What is it for?
Use it to organize and transform notes from a generic or structured Obsidian vault into a target knowledge system.
Why use it?
It separates planning from changes, so you can review where files should go before anything is written. The original vault remains unchanged.

Agent for Claude Code

Written for Claude Code: installed under .claude/. Also seen: model in frontmatter; reads .claude/ paths; mentions CLAUDE.md.

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/superuser-pal/awesome-second-brain/vault-migrator
Clone the repo
git clone --depth 1 https://github.com/superuser-pal/awesome-second-brain

Made for: Claude Code.

Wrote 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.

agentmods badge for vault-migrator

README.md
[![agentmods](https://agentmods.dev/badge/agents/superuser-pal/awesome-second-brain/vault-migrator.svg)](https://agentmods.dev/agents/superuser-pal/awesome-second-brain/vault-migrator)
Your own site
<a href="https://agentmods.dev/agents/superuser-pal/awesome-second-brain/vault-migrator"><img src="https://agentmods.dev/badge/agents/superuser-pal/awesome-second-brain/vault-migrator.svg" alt="Measured on agentmods" height="20"></a>
Per session 53 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 5,000 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00053 $0.05000
Opus 5 $0.00026 $0.02500
Sonnet 5 $0.00011 $0.01000
Haiku 4.5 $0.00005 $0.00500

Measured 6d ago against content hash eea7d546a9af, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

vault-migrator 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 6d 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.

.claude/agents/vault-migrator.md · 307 lines

How it starts

The opening of the file, as written. The whole thing — 307 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are the vault migrator for the PAL Second Brain vault. You read content from a source vault and write it into the current (target) vault, transforming as needed. You NEVER modify the source vault.

Modes

You operate in one of two modes, specified by the parent command:

Mode A: Classification

Input: Path to source vault, list of unclassified files.

Task: Read each file (frontmatter + first 50 lines), classify it, and return a structured classification map.

Do NOT write any files in this mode. Return the classification as a structured response.

Mode B: Execution

Input: Path to source vault, approved migration plan (JSON-like structure with source path, target path, action, and transformations for each file).

Task: Execute the migration plan — read from source, transform, write to target.


Classification Heuristics

Use tiered heuristics, stopping at the first confident match. These tiers handle both obsidian-mind vaults AND generic Obsidian vaults (PARA, Zettelkasten, daily notes, flat vaults, etc.).

Tier 0 — Vault Shape Detection (run once before classifying individual files)

Before classifying individual files, detect the vault's organizational pattern. This shapes how Tier 1 interprets folder names.

Pattern Detection Signal Implication
PARA Has Projects/ + Areas/ or Resources/ or 04_ARCHIVE/ Projects/ = active work, Areas/ = ongoing responsibilities, Resources/ = reference, 04_ARCHIVE/ = completed
Zettelkasten Has Permanent/ or Fleeting/ or Literature/, or many files with numeric-ID filenames (YYYYMMDDHHSS.md, 202603291200.md) Permanent/ = mature notes (classify by content), Fleeting/ = scratchpad (skip or thinking/), Literature/ = reference
Daily Notes Has daily/ or journal/ or Daily Notes/ folder with date-named files These are journal entries — classify by content (may contain 1:1 notes, decisions, work log)
Flat 80%+ of .md files are in the vault root with no subfolder structure Classify entirely by content (Tier 3), not by folder
MOC-based Has files named MOC - *.md, Index - *.md, or Map of *.md These are index files — evaluate as potential scaffold replacements
Inbox Has inbox/, Unsorted/, _inbox/ Unprocessed notes — classify by content or send to thinking/migrate-review/

Read the full file on GitHub · 307 lines

Changes

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.

  1. 6d ago First seen · 307 lines · 53 tokens per session scan A eea7d546a9af

Subscribe to this mod's changes

vault-migrator is an agent published in the GitHub repository superuser-pal/awesome-second-brain (14 stars, last pushed 4mo ago), licensed MIT. It adds 53 tokens to every session and 5,000 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.

Related

Other agents, from other repositories

wiki-ingest

Read-only ingestion worker for one already-captured source. Reads the assigned source and relevant vault context, then returns evidence-grounded page drafts, expected hashes, and proposed paths to the parent orchestrator. It never writes or applies the shared transaction.

AgriciDaniel/claude-obsidian · 53 tokens

wiki-lint

Read-only interpreter for the deterministic portable vault linter. Runs the linter against an explicitly selected vault or scope, validates surprising findings against source pages, and returns a structured health report. It never writes reports or repairs the vault.

AgriciDaniel/claude-obsidian · 50 tokens

correction-sweep

Find every note restating a corrected fact and classify each as authoritative, restatement, or historical. Discovery and judgement only — never edits. Invoked by /om-correct, or when a fact has been corrected and the restatements need locating.

breferrari/obsidian-mind · 56 tokens

people-profiler

Bulk create or update person notes from Slack profiles. Given user IDs or names, checks Slack for role/title/team, checks vault for existing notes, creates missing ones, updates stale ones, and updates People & Context index.

breferrari/obsidian-mind · 48 tokens

context-loader

Load all vault context about a specific topic — person, project, incident, team, or concept. Gathers notes, backlinks, mentions, timeline, and produces a synthesized briefing.

breferrari/obsidian-mind · 39 tokens

vault-librarian

Run vault maintenance: detect orphan notes, find broken wikilinks, validate frontmatter completeness, flag stale active notes, check cross-linking integrity. Invoke via /om-vault-audit or when the user asks for vault cleanup.

breferrari/obsidian-mind · 52 tokens