Your Obsidian vault, but with Claude Code living inside it
Claudian turns your Obsidian vault into an AI agent's working directory, embedding Claude Code, Codex, and others so they can read, write, and search your notes like a codebase.

What it does
Claudian is an Obsidian plugin that embeds AI coding agents—Claude Code, Codex, Opencode, and Pi—directly into your note vault. It treats your markdown collection as the agent’s working directory, granting read/write access, search, and bash execution. You chat via a sidebar or trigger inline edits with word-level diff previews, and can pull in external files or MCP servers using @mentions.
The interesting bit
Rather than bolting a generic LLM chatbot onto a note-taking app, Claudian wraps the actual CLI agents as subprocesses behind a provider-neutral runtime. Your vault becomes a live project environment where agents draft implementation plans for approval, fork conversations, and invoke external tools without ever leaving Obsidian.
Key highlights
- Multi-provider support: Claude Code, OpenAI Codex, Opencode, and Pi, abstracted behind a shared runtime and approval layer.
- Native vault operations: agents read, write, search, and run bash as if your notes were a repository.
- Plan Mode requires the agent to explore and design before implementing.
- MCP server connectivity over stdio, SSE, and HTTP.
- Conversation management with tabs, history forking, resuming, and compaction.
- Inline editing with word-level diffs and
@mentionsupport for files, subagents, and external directories. - Desktop only (macOS, Linux, Windows); requires Obsidian v1.7.2+.
Caveats
- Desktop-only; mobile is not supported.
- Codex, Opencode, and Pi support is live but explicitly flagged as incomplete and lightly tested across platforms.
- CLI auto-detection is brittle with Node version managers (
nvm,fnm,volta), and Windows users must avoid.cmd/.ps1wrappers.
Verdict
A solid fit if you already treat Obsidian as a knowledge base that needs active maintenance and you don’t mind installing CLI backends. Skip it if you need mobile access or a zero-config setup—getting the provider binaries visible to Obsidian can involve PATH wrestling.
Frequently asked
- What is YishenTu/claudian?
- Claudian turns your Obsidian vault into an AI agent's working directory, embedding Claude Code, Codex, and others so they can read, write, and search your notes like a codebase.
- Is claudian open source?
- Yes — YishenTu/claudian is open source, released under the MIT license.
- What language is claudian written in?
- YishenTu/claudian is primarily written in TypeScript.
- How popular is claudian?
- YishenTu/claudian has 14.3k stars on GitHub and is currently cooling off.
- Where can I find claudian?
- YishenTu/claudian is on GitHub at https://github.com/YishenTu/claudian.