Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
docs(agents): document running Cursor agents from Macro (#9314)
Wolf Mermelstein8a7b457e4433
diff --git a/apps/docs/AI/cursor.mdx b/apps/docs/AI/cursor.mdxnew file mode 100644index 0000000000..22041266b8--- /dev/null+++ b/apps/docs/AI/cursor.mdx@@ -0,0 +1,58 @@+---+title: "Cursor"+sidebarTitle: "Cursor"+icon: "code"+description: "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.++<Note>+ Your Cursor plan must include [cloud agents](https://cursor.com/docs/cloud-agent), and a Cursor account admin must connect source control for your Cursor account.+</Note>++## Connect Cursor++<Steps>+ <Step title="Create an API key in Cursor">+ In the [Cursor dashboard](https://cursor.com/dashboard/api), open **API & SSH Keys** and click **New API Key**.+ </Step>+ <Step title="Paste it into Macro">+ Open **Settings → General → Agents → Runtimes**, choose **Cursor**, and paste the key. Macro stores it encrypted and only uses it to start and follow your Cursor sessions.+ </Step>+ <Step title="Choose a default model">+ New Cursor agents start with this model. You can change it per agent.+ </Step>+</Steps>++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](/product/channels), @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](/integrations/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:++<Steps>+ <Step title="Open your agent list in Cursor">+ Go to [cursor.com/agents](https://cursor.com/agents), or open the agents window in Cursor.+ </Step>+ <Step title="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.+ </Step>+</Steps>++<Note>+ Macro starts sessions with your own API key, so they appear under **My agents**.+</Note>diff --git a/apps/docs/docs.json b/apps/docs/docs.jsonindex 89e4270e9c..43928c5801 100644--- a/apps/docs/docs.json+++ b/apps/docs/docs.json@@ -98,6 +98,7 @@"pages": ["AI/recipes","AI/bring-your-own",+ "AI/cursor","AI/mcp/overview",{"group": "Tool Reference",diff --git a/apps/docs/product/agents.mdx b/apps/docs/product/agents.mdxindex 680b326a6b..0e787e9702 100644--- a/apps/docs/product/agents.mdx+++ b/apps/docs/product/agents.mdx@@ -84,7 +84,7 @@ A [skill](/product/skills) is a saved set of instructions an agent follows. Type### Custom agents-**Settings → Agents** creates agents with a name, instructions, default model, and runtime. A runtime is Macro's AI, a hosted coding agent, or an agent running on your computer. See [Bring your own agent](/AI/bring-your-own) to connect Claude Code, Codex, or another local agent.+**Settings → Agents** creates agents with a name, instructions, default model, and runtime. A runtime is Macro's AI, a hosted coding agent, or an agent running on your computer. See [Bring your own agent](/AI/bring-your-own) to connect Claude Code, Codex, or another local agent. See [Cursor](/AI/cursor) to run coding agents on your Cursor plan.### Choosing a model