RAIT-09/obsidian-agent-client

Bring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.

What it solves

This plugin transforms Obsidian into a front-end for AI agents, eliminating the need to copy-paste content between your notes and external AI tools. It allows you to interact with various AI agents directly within your knowledge base, giving them the ability to read and edit your vault notes based on your instructions.

How it works

Built on the Agent Client Protocol (ACP), the plugin launches locally installed agents (such as Claude Code, Codex, or Gemini CLI) as child processes. It integrates with Obsidian's vault API to provide the agent with access to your notes. Users can mention specific notes using @ mentions, and the agent can perform actions like editing notes with visible word-level diffs, running terminal commands with live output, and utilizing MCP servers and skills.

Who it’s for

Obsidian users who use AI agents for coding, writing, or project management and want a seamless integration where the agent has direct access to their personal knowledge base.

Highlights

  • Multi-session support: Run multiple agents simultaneously in sidebar tabs, editor tabs, or floating windows.
  • Note Mentions: Use @ to reference notes, with the active note and selected text being automatically mentioned.
  • Integrated Edits: Note changes are displayed as word-level diffs in the chat interface.
  • ACP Compatibility: Works with a wide range of ACP-compatible agents including Claude Code, Codex, and Gemini CLI.
  • Permission System: Approve or reject agent actions via permission prompts to maintain security.
  • Session Management: A dedicated manager to track and open conversations across the workspace.
  • Coded Block Embedding: Embed live chats directly inside notes using code blocks.

Related

  • Project
    YishenTu/claudian

    Claudian is an Obsidian plugin that embeds multiple AI coding agents (Claude Code, Codex, Grok Build, OpenCode, Pi, DeepSeek Harness) into your vault, allowing the model to read/write files, run commands, and manage multi‑step workflows. It offers inline editing, Zen mode, slash‑command skills, @‑mentions, side chats, tabbed sessions, and MCP server integration. Installation is via the Obsidian community plugins store or from source. The plugin sends only your prompts and tool outputs to the chosen provider, with no telemetry. It includes detailed troubleshooting for CLI detection, model discovery, and authentication issues. Licensed under MIT and sponsored by Moonshot AI and BEIKE.

  • Project
    freestylefly/wesight-obsidian

    An Obsidian plugin that integrates local AI agents like Claude Code and Codex for vault-aware chat and inline editing, featuring a comprehensive workbench for publishing notes to social media and professional platforms.

  • Project
    aaronsb/obsidian-mcp-plugin

    An Obsidian plugin that turns your vault into an MCP server, allowing AI assistants to read, write, and navigate your notes as a connected knowledge graph.

  • Project
    allenhutchison/obsidian-gemini

    Gemini Scribe is an Obsidian plugin that connects to Gemini, Ollama, OpenAI, or Anthropic models, turning the note‑taking app into an AI‑driven assistant. It offers an agent with tool‑calling (file search, create/edit notes, deep research), per‑feature provider routing, semantic vault search, smart summarisation, IDE‑style completions, scheduled tasks, lifecycle hooks, and project‑scoped skills—all stored locally as markdown files.

  • Project
    logancyang/obsidian-copilot

    Obsidian Copilot is an open‑source Obsidian plugin that adds AI agents (opencode, Claude Code, or Codex) for multi‑step research, writing, and knowledge‑work. Agents can read/write notes, run tools, and keep context across turns. You can use hosted models, bring‑your‑own‑API keys, or local models; free use works with your own provider, while paid plans unlock hosted services and multi‑agent features.