# Agent Client Protocol for Raycast

URL: https://www.raycast.com/Yukai/agent-client-protocol

> Connect to AI agents via Agent Client Protocol for coding assistance

- Install: raycast://extensions/Yukai/agent-client-protocol
- Author: [Yukai Huang](https://www.raycast.com/Yukai)
- Installs: 601
- Platforms: macOS, Windows
- Categories: Developer Tools
- Updated: 2026-04-03
- Source: https://github.com/raycast/extensions/tree/870667fc671801a467deb7c4c7fc72992efe3820/extensions/agent-client-protocol/

## Commands

- **Ask AI Agent**: Configure and start a conversation with an AI agent
- **View Conversations**: Browse and manage past conversations
- **Configure Agents**: Manage AI agent configurations

## README

### Agent Client Protocol

Connect to AI agents via Agent Client Protocol for coding assistance directly from Raycast.

#### Setup

##### 1. Install an ACP-compatible agent

This extension works with any agent that supports the Agent Client Protocol:

- **[Claude Code](https://github.com/zed-industries/claude-code-acp)** - Anthropic's official CLI (recommended)
- **[Gemini CLI](https://github.com/google-gemini/gemini-cli)** - Google's AI assistant
- **Custom agents** - Any tool implementing the [ACP specification](https://agentclientprotocol.com)

Follow the installation instructions from the agent's official documentation.

##### 2. Configure the agent in Raycast

1. Open **Configure Agents** command
2. Select a built-in agent or create a custom configuration
3. Fill in the required fields:
   - **Command**: Path to the agent binary (e.g., `claude-code-acp`)
   - **Arguments**: Any required arguments (e.g., `--experimental-acp` for Gemini)
   - **Environment Variables**: API keys and other variables in JSON format
   - **Additional PATH**: Add directories to PATH if needed

##### 3. Start chatting

Use the **Ask AI Agent** command to start a conversation.

#### Troubleshooting

**Exit code 127**: The agent binary cannot be found.
- Use the absolute path to the binary in the **Command** field
- Or add the binary's directory to **Additional PATH**

**Connection issues**: Enable logging in extension preferences to debug.

#### Commands

- **Ask AI Agent** - Start a new conversation
- **View Conversations** - Browse past conversations
- **Configure Agents** - Manage agent configurations