← all repositories
YishenTu/claudian

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.

14.3k stars TypeScript Coding AssistantsAgents
claudian
Velocity · 7d
+26
★ / day
Trend
cooling
star history

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 @mention support 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/.ps1 wrappers.

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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.