YishenTu /claudian
An Obsidian plugin that embeds Claude Code, Codex and other agents as an AI collaborator in your vault.
★ 15,999⑂ 1,095👁 39⑃ 1,361● 816▤ 116
+8
Daily
15,999
stars
1,095
forks
39
watchers
1,361
prs
816
issues
116
releases
README
Claudian
!Preview
An Obsidian plugin that embeds AI coding agents (Claude Code, Codex, Grok Build, Antigravity CLI, 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, Antigravity CLI, 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.
Projects — Group sessions that work toward a shared goal. Every member shares the project's instructions and a memory file that the agents keep current, and the agents can cooperate by finding, reading and messaging each other. See the Projects guide.
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. See the Cross-session messaging guide.
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.
Plugin API (experimental) — Let other Obsidian plugins send prompts to sessions, stop them and read their replies. See the Plugin API guide.
Collaboration — Collab is now a standalone plugin. See Claudian Collab.
Requirements
- At least one of the following harnesses:
- Antigravity CLI
- Claude Code
- Codex
- DeepSeek Harness
- Grok Build
- OpenCode V2
- Pi
- A compatible subscription or API provider
- Obsidian v1.13.0+
- Desktop only (macOS, Linux, Windows)
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:
bash
cd /path/to/vault/.obsidian/plugins
git clone https://github.com/YishenTu/claudian.git realclaudian
cd realclaudian
2. Install dependencies and build:
bash
npm install
npm run build
3. Top issues
#1178[Bug]: "During use, it got stuck. The thinking won't stop! It keeps spinning. Pressing Esc doesn't work, and there's no send button to stop the output!"6 comments · 2026-08-26#1339[Bug]: 2.2.7 removed the only live indicator that a command or agent is still running (StatusPanel deleted with the todo list)5 comments · 2026-09-14#2055[Feature]: Some way to turn off the automatic selection of 'Linked Content'4 comments · 2026-11-05#1609[Bug]: OAuth session expired and could not be refreshed for Claude4 comments · 2026-10-12#1229[Bug]: `edit_object_content` MCP tool call fails with generic "Error: unknown" (Heptabase MCP)4 comments · 2026-09-01#1190[Bug]: Open conversation reverts `providerState.leafEntryId` changed on the pi side — meta rewritten from stale in-memory state, `get_tree` never queried4 comments · 2026-08-28#1940[Feature]: Hand a chat off to a Remote Control terminal and back; show turns appended outside Claudian3 comments · 2026-10-30#1918[Feature]: Support Oh My Pi (omp) as a provider, or let the Pi provider run Pi-compatible runtimes3 comments · 2026-10-28
Discussions
#2199通过 Claudian 调用 Antigravity 响应和运行偏慢且频繁中断(对比原生 Antigravity CLI)1 comments · 2026-11-10#1920Modernized the Claudian UI + Voice (using Whisper)1 comments · 2026-10-28#1771FridayOS: a Six-Brain vault structure for separating sources, tasks and reusable methods0 comments · 2026-10-23#1307ChatGPT 61 comments · 2026-09-10#1207Would you want a session-sync companion plugin in Claudian?1 comments · 2026-08-30#1119authentication issue1 comments · 2026-08-19#1088Add copilot-cli similar to codex-cli0 comments · 2026-08-11#1033以后能兼容reasonix吗0 comments · 2026-08-03
Latest release
2.3.43 2.3.43 2026-11-14What's Changed - feat(chat): add a chat font size slider relative to note text (2224) - refactor(sessions): leave session bindings to the native harness (2225) - fix(questions): offer typed answers wherever the provider's protocol carries them (2223) - test: force a polled change when rewriting the antigravity transcript (2221) - feat(chat): always show message timestamps and drop the toggle (2220) - feat(chat): show titles on new chat tabs by default (2219) - fix(style): make provider icons legible in light-theme settings (2218) - fix(antigravity): drop between-turn output agy replays before