# obsidian

The original article builds a personal AI content factory with Obsidian + Claude. We rewrite it from a Tech Lead's perspective — managing a 6-person backend team with an AI-native doc system called orion-dev-doc.

Obsidian v1.12 ships an official CLI that lets you control your entire vault from the terminal. On the surface it's a power user tool — underneath, it's paving the road for AI agents. This article covers the full CLI command reference and demonstrates real Claude Code + Obsidian CLI workflows.

Humans have Tools for Thought like Obsidian. Claude needs an AI-native version. Build a knowledge graph using markdown, wiki links, hooks, and subagents where agents can actually think.

Imagine time-traveling through your notes. Claude Code's Async Hooks let you auto-commit after every edit without any slowdown, then read that history in actually useful ways. Your vault becomes a thinking journal that writes itself.

For vibe note-taking to work well, you must force Claude Code to be 'picky.' Use a 4-layer filtering mechanism (file tree → YAML descriptions → outline → full content) to make it more selective. This pattern is called Progressive Disclosure.

Editing long documents with Claude Code is usually painful. Instead of bringing text to Claude, leave instructions where they belong. Use curly braces to mark your thoughts and edit instructions — each annotation applies to its surrounding text. Position IS Context.

Meetings used to be overhead. Now yapping (chatting/rambling) is work. When my colleague and I 'chat' about a project, we record it. An hour later, the transcript is processed, and suddenly: we have docs, feature ideas are in the backlog, decisions are captured with reasoning, project status is updated. Yapping IS Work.

Heinrich's six-part tutorial series: Building an AI agent thinking infrastructure with Claude Code + Obsidian. From vault basics to context engineering to meta layers — a complete knowledge management system.

Heinrich spent a year building an 'OS for thinking with AI': let Claude Code operate your Obsidian vault, extract concepts, link ideas, and build a living representation of your thinking. You don't take notes anymore — you command a system that takes notes.