Connect ACP Agents

Use the open-source @agentrq/acp-gateway to connect Gemini CLI and other ACP-compatible agents to AgentRQ.

While Claude Code is natively supported, many other agents now support the Agent Client Protocol (ACP). AgentRQ provides an open-source bridge (ACP Gateway) that allows these agents to use AgentRQ workspaces for human-in-the-loop task management.

How it works

ACP Agent (e.g. Gemini)

ACP Gateway

AgentRQ MCP Server

1 Install ACP Gateway

The ACP Gateway is available via npm. You can run it directly using npx or install it globally.

# To install globally
npm install -g @agentrq/acp-gateway

# Or run directly via npx
npx @agentrq/acp-gateway -- [agent-command]

2 Configure .mcp.json

The Gateway reads your workspace configuration from .mcp.json. Place this file in your project root or any parent directory.

.mcp.json

{
  "mcpServers": {
    "agentrq": {
      "type": "http",
      "url": "https://WORKSPACE_ID.mcp.agentrq.com/mcp?token=TOKEN"
    }
  }
}

3 Start Your Agent

Run the gateway followed by your agent command. The gateway will spawn your agent as a subprocess and bridge the protocols.

Gemini CLI Example

$ acp-gateway -- gemini --acp

This launches Gemini CLI in ACP mode and connects it to the AgentRQ server defined in your .mcp.json.

Custom Agent Example

$ acp-gateway -- your-acp-agent --flag1 --flag2

The gateway passes all arguments after -- directly to your agent subprocess.

4 What the Gateway Bridges

Task Notifications

Forwarded from AgentRQ to your agent as ACP prompts.

Permission Requests

ACP agent requests permission → Gateway proxies to AgentRQ → verdict returned.

File Operations

Agents can read and write files relative to the current directory.

Tool Dispatch

Proxies ACP tool calls directly to AgentRQ MCP server tools.

Open Source Gateway

The ACP Gateway is open-source and community-driven. You can inspect the code, contribute fixes, or build your own specialized bridge.

View on GitHub

Setup Complete?

Learn how to manage your workspace next.