Obsidian Knowledge Agent

Point any agentic assistant at your Obsidian vault and talk to it — "save this link", "organize my inbox", "ingest the syllabus in Inbox". It reads how your vault is already organized, matches effort to the material, and writes notes that actually teach: a clean one-liner for a quick save, or a fully scaffolded collection with a concept-graph canvas for a whole course.

Then it does what a prompt-pack can't: it reflects on every run and rewrites its own rules. Each correction you make becomes a durable, reviewable lesson in your git history — applied automatically next time. No fine-tuning. No black box.

Before / after

You ask your agent to "make notes on this paper." It writes a flat summary to notes.md at the repo root, picks a filename you'll never find again, and moves on.

With the agent:

# you: "save this"
ML/Papers/Attention Is All You Need.md                  ← filed, not dumped
tags: [transformers, attention]                         ← your frontmatter, matched
see also: [[Self-Attention]], [[Positional Encoding]]   ← wired into what you know

A teaching-grade note in your vault's own conventions — the key equation in LaTeX, a runnable block, a diagram where each genuinely helps. And the next correction you make becomes a rule it keeps.

More in examples/.

Install

The most effort it'll ever ask of you. Same two-command flow for Claude Code and OpenAI Codex — add the marketplace, then install.

Claude Code

/plugin marketplace add Michael-OvO/obsidian-knowledge-agent

/plugin install obsidian-knowledge@obsidian-knowledge-agent

OpenAI Codex

codex plugin marketplace add Michael-OvO/obsidian-knowledge-agent

codex plugin add obsidian-knowledge@obsidian-knowledge-agent

You get the ingestion skill, all 12 commands, and the self-evolution hooks. Then run /obsidian-knowledge:setup in your vault — empty folder or an existing vault, it adapts — or just start talking to it.

curl -fsSL https://chatgpt.com/codex/install.sh | sh   # macOS / Linux
npm install -g @openai/codex                           # …or npm
brew install --cask codex                              # …or Homebrew

Prefer no plugin? Seed any folder with the rule files + learning state — works with any agent:

curl -fsSL https://raw.githubusercontent.com/Michael-OvO/obsidian-knowledge-agent/main/install.sh | bash -s -- /path/to/your/vault

First run: say "save this link" for one clean note, or drop a syllabus into Inbox/ and say "organize my inbox". Don't like what it did? Run reflect, approve the rule diff with evolve, and it won't repeat the mistake.

How it works — it picks the altitude

No rigid pipeline forced on every input. Before it writes, it stops at the altitude that fits the material:

1. A link or a thought       → one clean note, filed in the right place
2. A handful of sources      → a few notes + a light index
3. A whole syllabus or book  → the full scaffold: indexes, navigation,
                               a quality pass, and a concept-graph canvas