AI Coding Agents
Live in Your Vault
Embed Claude Code, Codex, and Opencode directly into Obsidian. Your vault becomes the AI's working directory — file reads/writes, terminal commands, multi-step workflows, all out of the box.
An AI Coding Experience Built for Knowledge Workers
More than a chat interface — Claudian gives AI deep access to understand and operate your Obsidian vault
-
Inline Edit
Select text or place your cursor, then hit the hotkey to edit directly in your notes. Word-level diff preview gives you precise control over every change.
-
Slash Commands & Skills
Type / or $ to invoke reusable prompt templates and skills from vault-level or user-level scopes. Extend your workflow with custom commands.
-
@Mention Anything
Type @ to reference vault files, sub-agents, MCP servers, or files in external directories. The AI gets full context instantly.
-
Plan Mode
Toggle with Shift+Tab. The AI explores and designs before implementing, presenting a plan for your approval — no blind execution.
-
Instruction Mode
Use # to add refined custom instructions from the chat input. Adjust AI behavior in real time without leaving the conversation.
-
MCP Servers
Connect external tools via the Model Context Protocol — stdio, SSE, and HTTP transports supported. Claude includes in-app MCP management.
-
Multi-Tab Conversations
Run multiple independent chat tabs simultaneously with full conversation history, fork, resume, and context compaction.
-
Multi-Provider Support
Switch between Claude Code, Codex, and Opencode in a unified interface, all sharing the same conversation model and workflow.
Supported AI Providers
Pick the AI coding tool you know, and use it natively inside Obsidian
-
Claude Code
Full SupportAnthropic's flagship AI coding assistant. Full feature support: inline edit, MCP management, skills, sub-agents, plugin integration, and compatible third-party providers (Openrouter, Kimi, etc.).
-
Codex
SupportedOpenAI Codex CLI integration. Supports send, streaming, cancel, history reload, fork, plan mode, image attachments, inline edit, and $ skills.
-
Opencode
SupportedEmerging open-source AI coding tool. Claudian is among the first to provide native Obsidian integration, with features actively expanding.
Up and Running in 3 Minutes
Choose the installation method that works best for you
Requirements
- Obsidian v1.4.5 or later
- macOS, Linux, or Windows (desktop only)
- Claude Code CLI (required when using the Claude provider)
- Codex CLI or Opencode (optional)
Go to the latest GitHub Release and download main.js, manifest.json, and styles.css
Create a folder at <your-vault>/.obsidian/plugins/claudian/
Copy the three downloaded files into that folder
Open Obsidian → Settings → Community Plugins → enable Claudian
Install and enable BRAT from the Obsidian Community Plugins market
Open BRAT settings → click Add Beta plugin
Enter the repo URL: https://github.com/YishenTu/claudian, click Add Plugin
Enable Claudian in Community Plugins (BRAT will notify you of new releases automatically)
Clone the repo into your vault's plugins folder:git clone https://github.com/YishenTu/claudian.git
Install dependencies: cd claudian && npm install
Build: npm run build
Enable Claudian in Obsidian → Settings → Community Plugins
Frequently Asked Questions
- I see "spawn claude ENOENT" or "Claude CLI not found". How do I fix it?
- The plugin can't auto-detect your Claude CLI installation. This is common with Node version managers (nvm, fnm, volta). Fix: leave the CLI path setting empty so Claudian can auto-detect. If that fails, run
which claude(macOS/Linux) orwhere.exe claude(Windows) and paste the path into Settings → Advanced → Claude CLI path. - The npm CLI and Node.js aren't in the same directory — what do I do?
- Run
dirname $(which claude)anddirname $(which node)to check if they match. If not, install the native binary instead, or add the Node.js path to Settings → Environment:PATH=/path/to/node/bin. - What features does Codex support?
- Codex supports: send, streaming, cancel, history reload, fork, plan mode, image attachments, inline edit, and $ skills. Not yet supported: rewind, runtime-discovered provider commands, in-app MCP management, and Claude plugin integration.
- Which Claude CLI path should I use on Windows?
- For native installs use
claude.exe; for npm installs, runnpm root -gto find the global root and usecli-wrapper.cjsfrom there. Avoid.cmdand.ps1wrappers, and the legacycli.js. - Does Claudian collect any of my data?
- No telemetry whatsoever. What gets sent to the API: your input, attached files, images, and tool-call outputs — to the API provider you configure (Anthropic or OpenAI by default). Local storage:
vault/.claudian/(settings) andvault/.claude/(Claude provider files). - Which platforms are supported?
- Claudian is desktop-only (macOS, Linux, Windows), requiring Obsidian v1.4.5+. Mobile (iOS/Android) is not supported.