Agent Client Plugin for Obsidian

Agent Client Plugin for Obsidian is a community plugin that integrates AI coding agents directly into the Obsidian note-taking app, built on top of the Agent Client Protocol (ACP) proposed by Zed. It provides a full chat interface within Obsidian, supporting @notename syntax to reference vault notes as agent context, image attachments, slash commands, terminal command execution, and MCP server pass-through.

Core Features#

• Note Mentions: @notename syntax to reference notes and provide knowledge context to agents
• Multi-Agent Support: Built-in support for Claude Code, Codex, Gemini CLI, with extensibility for custom agents like OpenCode, Qwen Code, Kiro, and Mistral Vibe
• Multi-Session: Run multiple agent sessions simultaneously in independent views
• Floating Chat: Collapsible floating chat window for quick access
• Mode & Model Switching: Switch AI models and agent modes within a chat
• Session History: Restore or fork previous conversations
• Terminal Integration: Agents can execute terminal commands and return results
• Chat Export: Save conversations as Markdown notes
• MCP Support: Agents use their own configured MCP servers without extra plugin setup

Architecture#

Follows a 4-layer design:

• Types (src/types/): Pure type definitions, no logic or dependencies
• ACP / Services (src/acp/ + src/services/): ACP protocol isolation layer + non-React business logic, all SDK dependencies scoped here
• Hooks (src/hooks/): React state management via useAgent facade hook combining sub-hooks
• UI (src/ui/): React components with ChatPanel as the central orchestrator

Key design patterns include the useAgent Facade Pattern (single onSessionUpdate subscription), Single Event Channel (all agent events through one channel), ACP Isolation (type-converter.ts as protocol change buffer), and React Context for Services (dependency injection). Performance optimizations include RAF batched streaming updates, @tanstack/react-virtual virtual scrolling, React.memo, and O(1) tool call indexing. Codebase is approximately 19,800 lines across 56 files, primarily TypeScript (91.4%) and CSS (8.0%).

Installation & Configuration#

Prerequisites: Obsidian (macOS/Linux/Windows including WSL), Node.js, and at least one installed AI agent with its ACP adapter.

Recommended installation via BRAT: Settings → BRAT → Add Beta Plugin → paste repo URL → enable Agent Client. Manual installation from Releases is also supported.

For Claude Code, install claude and @agentclientprotocol/claude-agent-acp, then configure Node.js path, agent executable path, and API Key in Settings → Agent Client.

Current Status#

Version 0.10.2, distributed via BRAT, not yet listed on the official Obsidian Community Plugins marketplace. Author RAIT-09's background is not publicly disclosed. ACP protocol maturity requires further tracking. Agents can execute arbitrary commands via terminal integration; whether the plugin provides permission approval or sandboxing is not documented.