# Obsidian Agent Client
Obsidian Agent Client is an [[Open Source]] [[Obsidian]] plugin that integrates AI agents directly into the note-taking environment using the Agent Client Protocol (ACP) developed by Zed Industries. It lets users chat with [[AI Agents]] without leaving their vault.
## Key Features
- **Note referencing**: mention vault notes in conversations using `@notename` syntax
- **Multi-agent support**: works with [[Claude Code]], Codex, Gemini CLI, and custom agents simultaneously
- **Image support**: drag-and-drop or paste images into chat
- **Slash commands**: access agent-provided commands via `/` prefix
- **Session management**: multiple concurrent sessions with history resumption
- **Floating interface**: persistent, collapsible chat window
- **Export**: save chat histories as Markdown
- **Terminal access**: agents can execute system commands and return output
- **Model switching**: change AI models and agent modes mid-conversation
## How It Works
The plugin acts as a bridge between Obsidian and AI agent platforms through the Agent Client Protocol (ACP). Users install the desired agent CLI tool along with its ACP adapter, configure paths in plugin settings, and interact through a floating chat interface within the editor.
## Tech Stack
- [[TypeScript]] (91.6% of codebase)
- CSS for styling
- ESBuild for bundling
- Apache 2.0 license
## Installation
- **Via BRAT**: install the BRAT plugin, then add the repository URL
- **Manual**: download `main.js`, `manifest.json`, and `styles.css` from releases into `.obsidian/plugins/agent-client/`
Requires Node.js and the desired agent CLI tool with its ACP adapter.
## References
- https://github.com/RAIT-09/obsidian-agent-client
## Related
- [[Obsidian]]
- [[AI Agents]]
- [[Claude Code]]
- [[TypeScript]]
- [[Open Source]]