Verified project record

YishenTu/claudian

Claudian is an Obsidian plugin that turns a desktop vault into a working directory for AI coding agents, supporting file operations, search, Bash, and multi-step workflows. It requires a provider API such as Anthropic or OpenAI, meaning vault inputs and attached files are sent to external services.

Project overview

It embeds multiple AI coding agents, including Claude Code and Codex CLI, directly within Obsidian to operate on vault contents via a sidebar interface.

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

Best for

Desktop Obsidian users on macOS, Linux, or Windows who want to use their vault as a working directory for supported AI coding agents.
Developers who want to manage multi-step agent workflows, file edits, and conversations directly within their note-taking environment.

Key capabilities

Uses the vault as the configured agent's working directory for file read/write, search, Bash, 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, and is not documented for mobile use.
Inputs, attached files, images, and tool call outputs are sent to the provider API, which may include 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

Open original GitHub project