/refactor
Reorganize notes and folders safely — rename, move, split, merge — and rewire every affected wikilink
> /plugin marketplace add Michael-OvO/obsidian-knowledge-agent > /plugin install obsidian-knowledge@obsidian-knowledge-agent
How it fires
How this command gets triggered: by you, by Claude, or both.
- Fires itselfClaude auto-loads it when your prompt matches the work.
- You can call itInvoke it directly when you want it.
- Slash command
/refactor
Context preview
What this command does when you run it.
Reorganize notes and folders safely — rename, move, split, merge — and rewire every affected wikilink
Command definition
refactor.mddescription: Reorganize notes and folders safely — rename, move, split, merge — and rewire every affected wikilink argument-hint: <the change, e.g. "rename ML to Machine Learning" or "split the Transformers note">
Carry out the restructuring in `$ARGUMENTS` without breaking the vault.
1. **Plan.** State exactly what will move, rename, split, or merge, and which files link to the affected notes (search for wikilinks to them). Show me the plan before changing anything. 2. **Baseline.** Validate links first (`scripts/validate_links.py`) so we know the starting point is clean. 3. **Execute** with `git mv` where possible (preserve history). For a split, create the new notes and move the relevant content; for a merge, combine and redirect. Preserve frontmatter. 4. **Rewire EVERY wikilink** that pointed at a moved/renamed/merged note — including aliased and table-escaped (`\|`) links — and update any indexes and concept-graph canvas. 5. **Re-validate links** (must be zero broken) and **commit**. Never delete a note without my explicit approval — leave a redirect stub or archive it instead.
Talk to your vault. It does the rest. You drop it in. It files, it teaches, and it remembers how you like your notes. Point any agentic assistant at your Obsidian vault and talk to it — "save this link", "organize my inbox", "ingest the syllabus in Inbox".
Repo: Michael-OvO/obsidian-knowledge-agent
Other commands on obsidian-knowledge-agent.
- /capture
Quickly save something as a single clean note in the right place — a link, a thought, an article, a snippet
Open command - /clean
Tidy and sync — commit changed notes, clear processed Inbox (with approval), and push
Open command - /doctor
Check vault health — broken links, orphans, missing frontmatter, MISSING placeholders — and propose fixes
Open command - /evolve
Review and approve the agent's proposed updates to its own learned rules
Open command - /help
Show everything the Obsidian Knowledge Agent can do, with every command and an example
Open command - /ingest
Turn material into notes at the right altitude — a quick capture, a small collection, or a full build
Open command

