Repolode
YishenTu

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

    Install Claudian from Obsidian Community Plugins (Settings → Community plugins → Browse → search "Claudian")

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