Claudian
An Obsidian plugin that embeds Claude Code as an AI collaborator in your vault
Ask AI about Claudian
Powered by Claude Β· Grounded in docs
I know everything about Claudian. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Claudian

An Obsidian plugin that embeds AI coding agents (Claude Code, Codex, Opencode and more to come) in your vault. Your vault becomes the agent's working directory β file read/write, search, bash, and multi-step workflows all work out of the box.
Features & Usage
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 and Opencode β talk to the agent, and it reads, writes, edits, and searches files in your vault.
Inline Edit β Select text or start at the cursor position + hotkey to edit directly in notes with word-level diff preview.
Slash Commands & Skills β Type / or $ for reusable prompt templates or Skills from user- and vault-level scopes.
@mention - Type @ to mention anything you want the agent to work with, vault files, subagents, MCP servers, or files in external directories.
Plan Mode β Toggle via Shift+Tab. The agent explores and designs before implementing, then presents a plan for approval.
Instruction Mode (#) β Refined custom instructions added from the chat input.
MCP Servers β Connect external tools via Model Context Protocol (stdio, SSE, HTTP). Claude manages vault MCP in-app; Codex uses its own CLI-managed MCP configuration.
Multi-Tab & Conversations β Multiple chat tabs, conversation history, fork, resume, and compact.
Requirements
- Claude provider: Claude Code CLI installed (native install recommended). Claude subscription/API or compatible provider (Openrouter, Kimi, etc.).
- Optional providers: Codex CLI, Opencode.
- Obsidian v1.4.5+
- Desktop only (macOS, Linux, Windows)
Installation
From GitHub Release (recommended)
- Download
main.js,manifest.json, andstyles.cssfrom the latest release - Create a folder called
claudianin your vault's plugins folder:/path/to/vault/.obsidian/plugins/claudian/ - Copy the downloaded files into the
claudianfolder - Enable the plugin in Obsidian:
- Settings β Community plugins β Enable "Claudian"
Using BRAT
BRAT (Beta Reviewers Auto-update Tester) allows you to install and automatically update plugins directly from GitHub.
- Install the BRAT plugin from Obsidian Community Plugins
- Enable BRAT in Settings β Community plugins
- Open BRAT settings and click "Add Beta plugin"
- Enter the repository URL:
https://github.com/YishenTu/claudian - Click "Add Plugin" and BRAT will install Claudian automatically
- Enable Claudian in Settings β Community plugins
Tip: BRAT will automatically check for updates and notify you when a new version is available.
From source (development)
-
Clone this repository into your vault's plugins folder:
cd /path/to/vault/.obsidian/plugins git clone https://github.com/YishenTu/claudian.git cd claudian -
Install dependencies and build:
npm install npm run build -
Enable the plugin in Obsidian:
- Settings β Community plugins β Enable "Claudian"
Development
# Watch mode
npm run dev
# Production build
npm run build
Tip: Copy
.env.local.exampleto.env.localornpm installand setup your vault path to auto-copy files during development.
Privacy & Data Use
- Sent to API: Your input, attached files, images, and tool call outputs. Default: Anthropic (Claude) or OpenAI (Codex); configurable via environment variables.
- Local storage: Claudian settings and session metadata in
vault/.claudian/; Claude provider files invault/.claude/; transcripts in~/.claude/projects/(Claude) and~/.codex/sessions/(Codex). - No telemetry: No tracking beyond your configured API provider.
Troubleshooting
Claude CLI not found
If you encounter spawn claude ENOENT or Claude CLI not found, the plugin can't auto-detect your Claude installation. Common with Node version managers (nvm, fnm, volta).
Solution: Leave the setting empty first so Claudian can auto-detect Claude Code. If auto-detection fails, find your CLI path and set it in Settings β Advanced β Claude CLI path.
| Platform | Command | Example Path |
|---|---|---|
| macOS/Linux | which claude | /Users/you/.volta/bin/claude |
| Windows (native) | where.exe claude | C:\Users\you\AppData\Local\Claude\claude.exe |
| Windows (npm) | npm root -g | {root}\@anthropic-ai\claude-code\cli-wrapper.cjs |
Note: On Windows, avoid
.cmdand.ps1wrappers. Useclaude.exefor native installs, orcli-wrapper.cjsfor package-manager installs.cli.jsis only a legacy fallback for older Claude Code npm packages.
Alternative: Add your Node.js bin directory to PATH in Settings β Environment β Custom variables.
npm CLI and Node.js not in same directory
If using npm-installed CLI, check if claude and node are in the same directory:
dirname $(which claude)
dirname $(which node)
If different, GUI apps like Obsidian may not find Node.js.
Solutions:
- Install native binary (recommended)
- Add Node.js path to Settings β Environment:
PATH=/path/to/node/bin
Other providers
Codex and Opencode support are live but features might be incomplete, and still need more testing across platforms and installation methods. If you have feature request or run into any bugs, please submit a GitHub issue.
Architecture
src/
βββ main.ts # Plugin entry point
βββ app/ # Shared defaults and plugin-level storage
βββ core/ # Provider-neutral runtime, registry, and type contracts
β βββ runtime/ # ChatRuntime interface and approval types
β βββ providers/ # Provider registry and workspace services
β βββ auxiliary/ # Shared provider auxiliary services
β βββ bootstrap/ # Plugin bootstrap wiring
β βββ security/ # Approval utilities
β βββ ... # commands, mcp, prompt, storage, tools, types
βββ providers/
β βββ claude/ # Claude SDK adaptor, prompt encoding, storage, MCP, plugins
β βββ codex/ # Codex app-server adaptor, JSON-RPC transport, JSONL history
β βββ opencode/ # Opencode adaptor
β βββ acp/ # Agent Client Protocol shared transport
βββ features/
β βββ chat/ # Sidebar chat: tabs, controllers, renderers
β βββ inline-edit/ # Inline edit modal and provider-backed edit services
β βββ settings/ # Settings shell with provider tabs
βββ shared/ # Reusable UI components and modals
βββ i18n/ # Internationalization (10 locales)
βββ types/ # Shared ambient types
βββ utils/ # Cross-cutting utilities
βββ style/ # Modular CSS
Roadmap
- 1M Opus and Sonnet models
- Codex provider integration
- Opencode support
- More to come!
License
Licensed under the MIT License.
