obsidian-agent-client

Bring AI agents (Claude Code, Codex, Gemini CLI) directly into Obsidian. Chat with your AI assistant right from your vault.

Built on Agent Client Protocol (ACP) by Zed.

https://github.com/user-attachments/assets/1c538349-b3fb-44dd-a163-7331cbca7824

Features

• Note Mentions: Reference your notes with @notename syntax
• Image Attachments: Paste or drag-and-drop images into the chat
• Slash Commands: Use / commands provided by your agent
• Multi-Agent Support: Switch between Claude Code, Codex, Gemini CLI, and custom agents
• Multi-Session: Run multiple agents simultaneously in separate views
• Floating Chat: A persistent, collapsible chat window for quick access
• Mode & Model Switching: Change AI models and agent modes from the chat
• Session History: Resume or fork previous conversations
• Chat Export: Save conversations as Markdown notes
• Terminal Integration: Let agents execute commands and return results
• MCP Support: Agents use their configured MCP servers — no extra setup needed in the plugin

Installation

From Community Plugins (Recommended)

1. Open Settings → Community Plugins → Browse
2. Search for "Agent Client"
3. Click Install, then Enable

Via BRAT (Pre-release Versions)

To try pre-release versions before they are published to Community Plugins:

1. Install the BRAT plugin
2. Go to Settings → BRAT → Add Beta Plugin
3. Paste: https://github.com/RAIT-09/obsidian-agent-client
4. Enable Agent Client from the plugin list

Manual Installation

1. Download main.js, manifest.json, styles.css from Releases
2. Place them in VaultFolder/.obsidian/plugins/agent-client/
3. Enable the plugin in Settings → Community Plugins

Quick Start

Open a terminal (Terminal on macOS/Linux, PowerShell on Windows) and run the following commands.

1. Install an agent and its ACP adapter (e.g., Claude Code):

   curl -fsSL https://claude.ai/install.sh | bash   # Install Claude Code
   npm install -g @agentclientprotocol/claude-agent-acp   # Install ACP adapter
   

2. Login (skip if using API key):

   claude
   

   Follow the prompts to authenticate with your Anthropic account.

3. Find the paths:

   which node   # macOS/Linux
   which claude-agent-acp
   
   where.exe node   # Windows
   where.exe claude-agent-acp
   

4. Configure in Settings → Agent Client:

   • Node.js path: e.g., /usr/local/bin/node
   • Built-in agents → Claude Code → Path: e.g., /usr/local/bin/claude-agent-acp (not claude)
   • API key: Add your key, or leave empty if logged in via CLI

5. Start chatting: Click the robot icon in the ribbon

Setup Guides

• Claude Code
• Codex
• Gemini CLI
• Custom Agents (OpenCode, Qwen Code, Kiro, Mistral Vibe, etc.)

Full Documentation

Development

npm install
npm run dev

For production builds:

npm run build

License

Apache License 2.0 - see LICENSE for details.

Star History