Agent Setup Overview

Agent Client supports multiple AI agents through the Agent Client Protocol (ACP). This section covers how to set up each supported agent.

Supported Agents

Agent	Provider	Package
Claude Code	Anthropic	@agentclientprotocol/claude-agent-acp
Codex	OpenAI	@agentclientprotocol/codex-acp
Gemini CLI	Google	@google/gemini-cli
Mistral Vibe	Mistral AI	mistral-vibe
OpenCode	Multi-provider	opencode-ai
Kiro	AWS	install script
Hermes Agent	Multi-provider	install script
Custom Agents	Various	Any ACP-compatible agent

Common Setup Steps

All agents follow a similar setup pattern:

1. Install the agent — see each agent's setup page for the exact command (npm for Claude Code / Codex / Gemini CLI; curl on macOS/Linux or uv on Windows for Mistral Vibe; curl or npm for OpenCode; curl on macOS/Linux or PowerShell on Windows for Kiro and Hermes Agent)
2. Set up authentication (API key or account login)

The plugin resolves bare command names through your login shell's PATH, so path configuration is often not needed. If the agent is not found automatically, use which (macOS/Linux) or where.exe (Windows) to find the path and configure it in Settings → Agent Client.

WSL Mode (Windows)

For Windows users, we recommend using WSL Mode for better compatibility:

1. Install WSL
2. Install Node.js and agents inside WSL
3. Enable WSL Mode in Settings → Agent Client
4. Use Linux-style paths (e.g., /usr/local/bin/node)

Switching Agents

Once you have multiple agents configured, you can switch between them using the ⋮ menu in the chat header. To change the default agent for new chat views, go to Settings → Agent Client → Default agent.