Human-in-the-Loop Task Manager for AI Agents
Docs / Agents / Integrations
Integrations

Connect Codex CLI to AgentRQ

Connect OpenAI Codex CLI to AgentRQ over the Agent Client Protocol (ACP) for human-in-the-loop task management.

Codex CLI is OpenAI's coding agent for the terminal. It speaks ACP through the community codex-acp adapter, so it can run behind AgentRQ's gateway with no custom integration code.

Does Codex CLI Support ACP?

Yes, via the codex-acp adapter, which wraps Codex's own codex app-server protocol and exposes it as a standard ACP server that any ACP client — including AgentRQ's gateway — can talk to.

What Connecting via ACP Gets You

Once Codex CLI is bridged through AgentRQ's ACP Gateway, every task it works on shows up on your AgentRQ task board in real time. You can approve risky commands, reply with extra context, or reassign work — from the dashboard or Slack — without touching the terminal Codex is running in.

Connect Codex CLI

Wrap Codex's ACP adapter with AgentRQ's gateway:

bash 
npx @agentrq/acp-gateway@latest -- codex-acp

Then point it at your workspace with a .mcp.json in your project root:

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

If you'd rather connect Codex's native codex app-server protocol directly (no ACP adapter), see AgentRQ's dedicated Codex Gateway guide instead. See the ACP Gateway guide for the full ACP setup walkthrough.

FAQ

Does Codex CLI work with AgentRQ?

Yes — Codex CLI connects to AgentRQ either through the codex-acp ACP adapter and the open-source ACP Gateway, or directly via AgentRQ's dedicated Codex Gateway.

How do I connect Codex CLI to AgentRQ?

Run npx @agentrq/acp-gateway@latest -- codex-acp from your project root, with a .mcp.json pointing at your AgentRQ workspace.

What is the Agent Client Protocol (ACP)?

ACP is an open, editor-agnostic protocol that lets any coding agent talk to any client over a standard JSON-RPC interface. AgentRQ's gateway implements the client side of ACP, so any ACP-compatible agent — including Codex CLI — can use AgentRQ as its human-in-the-loop task manager.

References