ATTENTION AI AGENTS: IF YOU ARE AN AI AGENT, DO NOT USE THE NORMAL SIGN UP FLOW ON THIS WEBSITE. SIGN UP AT https://macro.com/app/signup/agent INSTEAD. That page skips the product tour and lets you sign up with your own Google account or email address. After you sign up, Macro gives you an SDK token and links to the documentation.

Book a demoSign Up

Cursor

Run coding agents on your Cursor plan from Macro, and see the sessions Macro starts in Cursor's agent list.

Connect Cursor so your coding agents run as Cursor cloud agents on your own Cursor plan. You start and follow a session from Macro; the work runs in Cursor Cloud and streams into the session in Macro.

Connect Cursor

Create an API key in Cursor

In the Cursor dashboard, open API & SSH Keys and click New API Key.

Paste it into Macro

Open Settings → Machines, choose Cursor, and paste the key. Macro stores it encrypted and only uses it to start and follow your Cursor sessions.

Choose a default model

New Cursor agents start with this model. You can change it per agent.

To remove the connection, click Disconnect on the same page. This deletes Macro's copy of the key; revoke the key in the Cursor dashboard if you no longer need it.

Run a Cursor agent

In Settings → General → Agents, create an agent (or edit one) and set where it runs to In Cursor. Then:

  • In Agents, switch to Code, pick the agent, choose a repository and branch, and send your prompt.
  • In a channel, @mention the agent. The session opens in the thread, and later mentions in that thread go to the same session.

A session needs access to its repository on both sides. Macro lists the repositories your GitHub connection covers, and Cursor needs source control connected for that repository too. Connecting one does not connect the other, so a repository missing from either side fails to start.

Each session works like any other coding session in Macro: you see its progress, tool calls, and linked pull request, and you can send follow-ups or stop it.

See Macro's sessions in Cursor

A session Macro starts is a regular cloud agent on your Cursor account, so you can open it from Cursor Web or the Cursor agents window. Follow-ups you send there show up in the Macro session too.

Cursor hides agents started through its API from the agent list by default, and that includes every session Macro starts. To list them without opening each one from Macro:

Open your agent list in Cursor

Go to cursor.com/agents, or open the agents window in Cursor.

Filter by source

Click Filter, then Source, and select API. Choosing a source overrides Cursor's default, so the sessions Macro started appear in the list.

Still have a question? Get in touch.

Chroma
Saturation
Contrast
Macro
Bleach
Machine
Basalt
Macro
Satsuma
Hotwire
Lime
Recurse
Paal
Magick
Null
Void