ACP adapter for Cursor

Use Cursor from ACP-compatible clients such as Zed!

This tool implements an ACP adapter around the Cursor CLI, supporting:

• Context @-mentions
• Images
• Tool calls (with permission requests)
• Extended thinking
• Session history persistence
• Model selection (Claude, GPT, Gemini)
• Mode selection (default, plan, ask)
• Auth Methods:
  • Browser login (via cursor-agent login)
  • CURSOR_API_KEY

Learn more about the Agent Client Protocol.

How to use

Zed

Once registered in the ACP registry, Zed will be able to use this adapter out of the box.

To use Cursor, open the Agent Panel and click "New Cursor Thread" from the + button menu in the top-right.

Read the docs on External Agent support.

Other clients

Or try it with any of the other ACP compatible clients!

Prerequisites

Cursor CLI must be installed:

curl https://cursor.com/install -fsSL | bash

Installation

Install the adapter from the latest release for your architecture and OS: https://github.com/oxiglade/cursor-acp/releases

You can then use cursor-acp as a regular ACP agent:

cursor-acp

License

Apache-2.0