cursor-acp-bridge

ACP stdio bridge for Cursor CLI.

Why

Cursor CLI (cursor agent acp) has poor ACP support — persistent sessions fail with "Session ID Not Found" (Cursor Forum #155516). This bridge works around those issues.

Install

npm install -g cursor-acp-bridge

acpx Configuration

Add to ~/.acpx/config.json:

{
  "agents": {
    "cursor": {
      "command": "cursor-acp-bridge"
    }
  }
}

To use a different model:

{
  "agents": {
    "cursor": {
      "command": "cursor-acp-bridge --model gpt-4"
    }
  }
}

OpenClaw Configuration

Merge the following into your openclaw.json to register Cursor as an ACP agent:

{
  "plugins": {
    "entries": {
      "acpx": { "enabled": true },
    },
  },
  "acp": {
    "enabled": true,
    "backend": "acpx",
  },
  "agents": {
    "list": [
      {
        "id": "cursor",
        "runtime": {
          "type": "acp",
          "acp": {
            "agent": "cursor",
            "backend": "acpx",
          },
        },
      },
    ],
  },
}

To enable ACP session spawning in Telegram threads, also add:

{
  "channels": {
    "telegram": {
      "threadBindings": {
        "spawnAcpSessions": true,
      },
    },
  },
}

Then tell OpenClaw to "create a persistent cursor session".

Make sure cursor-acp-bridge is installed globally and configured in ~/.acpx/config.json (see above).