Verified project record

YishenTu/claudian

Claudian is an Obsidian plugin that makes a vault the working directory for AI coding agents such as Claude Code, Codex, Opencode, and Pi. It provides file operations, search, Bash execution, and multi-step workflows through a desktop chat sidebar on macOS, Linux, and Windows.

Project overview

Project type: MCP · AI Agent · AI Coding
Use cases: Coding & Development · Automation
Deployment: Refer to project documentation
License: MIT

Best for

Developers on macOS, Linux, or Windows who use Obsidian and want an AI coding agent to operate directly within their vault.
Users who want to connect external tools via Model Context Protocol alongside their vault files and subagents.

Key capabilities

Uses the vault as the configured agent's working directory for file read/write, search, Bash execution, and multi-step workflows.
Provides a sidebar for talking to an agent that reads, writes, edits, and searches vault files.
Edits selected text or text at the cursor directly in notes with a word-level diff preview.
Lets users mention vault files, subagents, MCP servers, and files in external directories for agent work.
Lets the agent explore and design before implementation and present a plan for approval.
Connects external tools through Model Context Protocol using stdio, SSE, or HTTP.
Supports multiple chat tabs, conversation history, forking, resuming, and compacting conversations.

Limitations and risks

Codex, Opencode, and Pi support may have incomplete features and need more testing across platforms and installation methods.
The plugin is documented as desktop-only for macOS, Linux, and Windows.
Inputs, attached files, images, and tool call outputs are sent to the provider API, such as Anthropic for Claude or OpenAI for Codex.
Provider subprocesses inherit the Obsidian process environment and variables configured in Claudian.

Getting started

Open Obsidian Settings, browse Community plugins, search for Claudian, click Install, and enable the plugin.

Evidence and sources

README: An Obsidian plugin that embeds AI coding agents (Claude Code, Codex, Opencode, Pi, and more to come) in your vault. Your vault becomes the agent's working directory — file read/wr…
README: Open the chat sidebar from the ribbon icon or command palette. Select text and use the hotkey for inline edit. Everything works like your familiar coding agent, Claude Code, Codex…
README: **Inline Edit** — Select text or start at the cursor position + hotkey to edit directly in notes with word-level diff preview.
README: **Slash Commands & Skills** — Type `/` or `$` for reusable prompt templates or Skills from user- and vault-level scopes.
README: **`@mention`** - Type `@` to mention anything you want the agent to work with, vault files, subagents, MCP servers, or files in external directories.

Reviewed at: 2026-07-21T07:05:20Z