Claudian

An Obsidian plugin that embeds AI coding agents (Claude Code, Codex, Grok Build, OpenCode, Pi, DeepSeek Harness, 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 Claudian interface from the ribbon icon or command palette. Everything works like your familiar coding agent, Claude Code, Codex, Grok Build, OpenCode, Pi, and DeepSeek Harness — talk to the agent, and it reads, writes, edits, searches and run commands in your vault.

Inline Edit — Select text or start at the cursor position + hotkey to edit directly in notes with word-level diff preview.

Zen Mode — Collapse the sidebar holding Claudian and the chat moves to a compact composer at the bottom of your notes, with a one-line activity preview and the conversation one click away.

Slash Commands & Skills — Type / or $ for reusable prompt templates or Skills from user- and vault-level scopes.

@mention — Type @ to reference vault files, folders and other Claudian sessions.

Cross-Session Messaging — Let agents read, message, steer or interrupt other Claudian sessions, or start new ones on any provider.

Side Chat (/side or /btw) — Explore a separate, temporary conversation with follow-ups and tools while keeping the main chat unchanged.

MCP Servers — Connect external tools through each coding agent's native CLI-managed MCP configuration.

Tabs & Session Management — Use multiple tabs in single-pane mode or a persistent session manager beside the chat in dual-pane mode.

Collaboration — Collab is now a standalone plugin. See Claudian Collab.

Requirements

• At least one of the following harnesses:
  • Claude Code
  • Codex
  • DeepSeek Harness
  • Grok Build
  • OpenCode
  • Pi
• A compatible subscription or API provider
• Obsidian v1.13.0+
• Desktop only (macOS, Linux, Windows)

Claudian now supports OpenCode v2, OpenCode v1 support will end on October 30, 2026. See the OpenCode v2 migration guide.

Installation

From Obsidian Community Plugins (recommended)

1. Open Obsidian → Settings → Community plugins → Browse
2. Search for "Claudian" and click Install
3. Enable the plugin

Or install directly from the community plugin page.

From source (development)

1. 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
   

2. Install dependencies and build:

   npm install
   npm run build
   

3. Enable the plugin in Obsidian:

   • Settings → Community plugins → Enable "Claudian"

Development

# Watch mode
npm run dev

# Production build
npm run build

Privacy & Data Use