An Obsidian plugin that brings AI agents such as opencode, Claude Code and Codex into your vault for research, writing and note work.
YishenTu/claudian
An Obsidian plugin that embeds AI coding agents such as Claude Code and Codex into your vault as a working collaborator.
- Stars
- 15,740
- Forks
- 1,064
- Open issues
- 70
- Last commit
- yesterday
What is it?
Claudian is an Obsidian plugin that puts AI coding agents inside your vault. The vault itself becomes the agent's working directory, so the agent can read, write, edit and search your notes, run bash commands, and carry out multi-step workflows without extra setup. Supported harnesses include Claude Code, Codex, Grok Build, OpenCode, Pi and DeepSeek Harness.
Beyond the chat sidebar, it offers inline editing with a word-level diff preview, a compact Zen Mode composer, slash commands and Skills, and @mentions for vault files, folders and other sessions. Agents can also message or steer other Claudian sessions, and MCP servers are configured through each agent's native CLI.
Claudian is desktop-only (macOS, Linux and Windows) and requires Obsidian v1.13.0 or later, plus at least one supported harness CLI and a compatible provider account or API key.
Key features
- 01Runs Claude Code, Codex, Grok Build, OpenCode, Pi and DeepSeek Harness inside Obsidian.
- 02Lets the agent read, write, edit, search notes and run bash commands in your vault.
- 03Provides inline edit with word-level diff preview directly in notes.
- 04Supports slash commands, Skills, and @mentions for files, folders and sessions.
- 05Allows cross-session messaging between Claudian chats.
- 06Connects MCP servers through each agent's native CLI configuration.
Use cases
- Drafting, rewriting or reorganizing notes with an AI agent that can see the whole vault.
- Running multi-step research or maintenance tasks across many Markdown files.
- Using an existing Claude Code or Codex subscription from within Obsidian.
- Making quick inline edits to a note without leaving the editor.
Quick start
- 1
Install Claudian from Obsidian Community Plugins (Settings → Community plugins → Browse → search "Claudian")
- 2
Enable the plugin in Obsidian (Settings → Community plugins → Enable "Claudian")
Things to know
- Desktop only (macOS, Linux, Windows), requires Obsidian v1.13.0+.
- You must separately install at least one supported agent CLI, such as Claude Code or Codex, plus a compatible subscription or API provider.
- OpenCode v1 support ends on October 30, 2026, so OpenCode users need to migrate to v2.
Topics
FAQ
- What is claudian?
- An Obsidian plugin that embeds AI coding agents such as Claude Code and Codex into your vault as a working collaborator. Claudian is an Obsidian plugin that puts AI coding agents inside your vault. The vault itself becomes the agent's working directory, so the agent can read, write, edit and search your notes, run bash commands, and carry out multi-step workflows without extra setup. Supported harnesses include Claude Code, Codex, Grok Build, OpenCode, Pi and DeepSeek Harness.
- Is claudian free to use? What license does it have?
- claudian is open source under the MIT license. Check the license terms before using it in commercial products.
- Is claudian still maintained?
- Actively maintained. The last commit to claudian was on Oct 20, 2026.
- What can I use claudian for?
- Drafting, rewriting or reorganizing notes with an AI agent that can see the whole vault. Running multi-step research or maintenance tasks across many Markdown files. Using an existing Claude Code or Codex subscription from within Obsidian. Making quick inline edits to a note without leaving the editor.
- How do I install claudian?
- Install Claudian from Obsidian Community Plugins (Settings → Community plugins → Browse → search "Claudian") Enable the plugin in Obsidian (Settings → Community plugins → Enable "Claudian")
- Where can I get claudian?
- The source code and installation instructions are on GitHub: https://github.com/YishenTu/claudian
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A desktop app that switches API providers in one click and manages MCP servers, Skills and prompts across Claude Code, Codex, Gemini CLI and other AI coding tools.
A set of Agent Skills that teach AI coding agents to work with Obsidian vaults and open formats like Markdown, Bases, and JSON Canvas.
Local-first agentic workspace where your apps, chat tools, integrations, memory and any agent (Claude Code, Codex, BYOK models) sit side by side.
An open-source Computer Use service exposed as an MCP server, letting AI agents control macOS, Linux, and Windows desktops.
Claude Code, Codex and OpenCode plugin that builds LLM-compiled, Obsidian-compatible knowledge bases through parallel research, source ingestion and querying.