@cursor/july 0.1.107 → 0.1.108
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -5
- package/dist/bin/agent-serve.js +30 -8
- package/dist/channels/github/github-channel.js +8 -5
- package/dist/channels/github/types.d.ts +5 -1
- package/dist/channels/github/types.d.ts.map +1 -1
- package/dist/channels/origin/origin-channel.d.ts.map +1 -1
- package/dist/channels/origin/origin-channel.js +27 -13
- package/dist/channels/origin/types.d.ts +5 -1
- package/dist/channels/origin/types.d.ts.map +1 -1
- package/dist/channels.d.ts +45 -0
- package/dist/channels.d.ts.map +1 -1
- package/dist/channels.js +106 -7
- package/dist/connections.d.ts +2 -1
- package/dist/connections.d.ts.map +1 -1
- package/dist/connections.js +2 -1
- package/dist/docs/404.html +2 -2
- package/dist/docs/ab.html +4 -4
- package/dist/docs/assets/{app.CtuckIiL.js → app.BASKM3M4.js} +1 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.BHZYsNVi.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.Bkkhnu8K.js → VPLocalSearchBox.BOKxlYGP.js} +1 -1
- package/dist/docs/assets/chunks/{theme.DhpIe0Pa.js → theme.DbDZW-zb.js} +2 -2
- package/dist/docs/assets/{deployment.md.MFPKqsqI.js → deployment.md.JenwuCCB.js} +4 -4
- package/dist/docs/assets/{deployment.md.MFPKqsqI.lean.js → deployment.md.JenwuCCB.lean.js} +1 -1
- package/dist/docs/assets/{evals.md.CbMoebP1.js → evals.md.C1ekS3k2.js} +1 -1
- package/dist/docs/assets/guides_cloud-agents.md.BsloyHdY.js +9 -0
- package/dist/docs/assets/{guides_cloud-agents.md.DS8RIjwx.lean.js → guides_cloud-agents.md.BsloyHdY.lean.js} +1 -1
- package/dist/docs/assets/{guides_github.md.c0gdGJ-D.js → guides_github.md.BH33UEBJ.js} +1 -1
- package/dist/docs/assets/{guides_grokbot-agents.md.DVqdhBKb.js → guides_grokbot-agents.md.DyV-WArv.js} +1 -1
- package/dist/docs/assets/guides_improve.md.BGVk32bK.js +14 -0
- package/dist/docs/assets/guides_improve.md.BGVk32bK.lean.js +1 -0
- package/dist/docs/assets/{guides_slack.md.9oHPye9o.js → guides_slack.md.D4RVMM4G.js} +3 -3
- package/dist/docs/assets/{guides_slack.md.9oHPye9o.lean.js → guides_slack.md.D4RVMM4G.lean.js} +1 -1
- package/dist/docs/assets/index.md.BjH1w2ZW.js +5 -0
- package/dist/docs/assets/{reference_agent-config.md.CHNpiyp4.js → reference_agent-config.md.CvoL6pof.js} +1 -1
- package/dist/docs/assets/{reference_cli.md.Dm67hd2D.js → reference_cli.md.Ca26u0Es.js} +6 -6
- package/dist/docs/assets/{reference_cli.md.Dm67hd2D.lean.js → reference_cli.md.Ca26u0Es.lean.js} +1 -1
- package/dist/docs/assets/{reference_connections.md.Di6jJAXF.js → reference_connections.md.BojkC6c5.js} +1 -1
- package/dist/docs/assets/{reference_extensions.md.CGmMLblt.js → reference_extensions.md.CPWt00ds.js} +1 -1
- package/dist/docs/assets/{scaffolding-agents.md.em43xlY1.js → scaffolding-agents.md.Kctn3OVb.js} +1 -1
- package/dist/docs/assets/{skills_create-agent.md.BVoWPcan.js → skills_create-agent.md.Q3h6Je-e.js} +1 -1
- package/dist/docs/assets/{skills_debug.md.CDbPhHfg.js → skills_debug.md.CVjCXMFF.js} +1 -1
- package/dist/docs/assets/{skills_debug.md.CDbPhHfg.lean.js → skills_debug.md.CVjCXMFF.lean.js} +1 -1
- package/dist/docs/assets/{skills_evals.md.723kpUmA.js → skills_evals.md.BhovOvrl.js} +1 -1
- package/dist/docs/assets/skills_framework-map.md.D-tFZhFS.js +1 -0
- package/dist/docs/assets/{skills_framework-map.md.haibFyoB.lean.js → skills_framework-map.md.D-tFZhFS.lean.js} +1 -1
- package/dist/docs/assets/{skills_github.md.D0JahM8c.js → skills_github.md.hgFX_oKY.js} +1 -1
- package/dist/docs/assets/troubleshooting.md.CYEAO9bM.js +1 -0
- package/dist/docs/building-with-agents.html +4 -4
- package/dist/docs/concepts.html +4 -4
- package/dist/docs/deployment.html +7 -7
- package/dist/docs/deployment.md +7 -2
- package/dist/docs/evals.html +6 -6
- package/dist/docs/evals.md +3 -2
- package/dist/docs/guides/agent-to-agent.html +4 -4
- package/dist/docs/guides/cloud-agents.html +6 -6
- package/dist/docs/guides/cloud-agents.md +4 -3
- package/dist/docs/guides/convert-automation.html +4 -4
- package/dist/docs/guides/github.html +5 -5
- package/dist/docs/guides/github.md +2 -1
- package/dist/docs/guides/grokbot-agents.html +6 -6
- package/dist/docs/guides/grokbot-agents.md +2 -2
- package/dist/docs/guides/human-in-the-loop.html +4 -4
- package/dist/docs/guides/improve.html +40 -0
- package/dist/docs/guides/improve.md +91 -0
- package/dist/docs/guides/mcp-oauth.html +4 -4
- package/dist/docs/guides/opentelemetry.html +5 -5
- package/dist/docs/guides/slack.html +6 -6
- package/dist/docs/guides/slack.md +2 -1
- package/dist/docs/guides/webhooks.html +4 -4
- package/dist/docs/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +4 -4
- package/dist/docs/index.html +6 -6
- package/dist/docs/index.md +4 -0
- package/dist/docs/llms-full.txt +158 -33
- package/dist/docs/llms.txt +1 -0
- package/dist/docs/quickstart.html +4 -4
- package/dist/docs/reference/agent-config.html +6 -6
- package/dist/docs/reference/agent-config.md +5 -2
- package/dist/docs/reference/artifacts.html +4 -4
- package/dist/docs/reference/channels.html +4 -4
- package/dist/docs/reference/cli.html +10 -10
- package/dist/docs/reference/cli.md +18 -11
- package/dist/docs/reference/connections.html +6 -6
- package/dist/docs/reference/connections.md +2 -1
- package/dist/docs/reference/extensions.html +6 -6
- package/dist/docs/reference/extensions.md +2 -0
- package/dist/docs/reference/hooks.html +4 -4
- package/dist/docs/reference/http-api.html +4 -4
- package/dist/docs/reference/instructions.html +4 -4
- package/dist/docs/reference/playground.html +4 -4
- package/dist/docs/reference/project-layout.html +4 -4
- package/dist/docs/reference/prompt.html +4 -4
- package/dist/docs/reference/result.html +4 -4
- package/dist/docs/reference/schedules.html +4 -4
- package/dist/docs/reference/sessions.html +4 -4
- package/dist/docs/reference/skills.html +4 -4
- package/dist/docs/reference/subagents.html +4 -4
- package/dist/docs/reference/tools.html +4 -4
- package/dist/docs/scaffolding-agents.html +5 -5
- package/dist/docs/scaffolding-agents.md +2 -1
- package/dist/docs/skills/ab.html +4 -4
- package/dist/docs/skills/create-agent.html +6 -6
- package/dist/docs/skills/create-agent.md +1 -1
- package/dist/docs/skills/debug.html +5 -5
- package/dist/docs/skills/debug.md +1 -1
- package/dist/docs/skills/evals.html +6 -6
- package/dist/docs/skills/evals.md +1 -1
- package/dist/docs/skills/framework-map.html +5 -5
- package/dist/docs/skills/framework-map.md +4 -2
- package/dist/docs/skills/github.html +6 -6
- package/dist/docs/skills/github.md +1 -1
- package/dist/docs/skills/hillclimb.html +4 -4
- package/dist/docs/skills/index.html +4 -4
- package/dist/docs/skills/mcp-auth.html +4 -4
- package/dist/docs/skills/otel.html +4 -4
- package/dist/docs/skills/setup-slack.html +4 -4
- package/dist/docs/storage.html +4 -4
- package/dist/docs/templates/agentic-owners.html +4 -4
- package/dist/docs/templates/agents-md.html +4 -4
- package/dist/docs/templates/code-wiki.html +4 -4
- package/dist/docs/templates/demo.html +4 -4
- package/dist/docs/templates/grokbot-agents.html +4 -4
- package/dist/docs/templates/pr-autofixer.html +4 -4
- package/dist/docs/templates/security-help.html +4 -4
- package/dist/docs/templates/security-reviewer.html +4 -4
- package/dist/docs/templates/triage.html +4 -4
- package/dist/docs/troubleshooting.html +5 -5
- package/dist/docs/troubleshooting.md +1 -1
- package/dist/extensions/improve/extension.d.ts +46 -0
- package/dist/extensions/improve/extension.d.ts.map +1 -0
- package/dist/extensions/improve/extension.js +41 -0
- package/dist/extensions/improve/skills/yourself.d.ts +4 -0
- package/dist/extensions/improve/skills/yourself.d.ts.map +1 -0
- package/dist/extensions/improve/skills/yourself.js +43 -0
- package/dist/internal/builtin-tools/artifacts.d.ts.map +1 -1
- package/dist/internal/builtin-tools/artifacts.js +2 -3
- package/dist/internal/channel-route-dispatch.d.ts +13 -0
- package/dist/internal/channel-route-dispatch.d.ts.map +1 -0
- package/dist/internal/channel-route-dispatch.js +62 -0
- package/dist/internal/channel-state.d.ts +17 -0
- package/dist/internal/channel-state.d.ts.map +1 -0
- package/dist/internal/channel-state.js +78 -0
- package/dist/internal/cli-ax.d.ts +7 -0
- package/dist/internal/cli-ax.d.ts.map +1 -1
- package/dist/internal/cli-ax.js +99 -1
- package/dist/internal/cli-cursor.d.ts.map +1 -1
- package/dist/internal/cli-cursor.js +2 -0
- package/dist/internal/cli-deploy.d.ts.map +1 -1
- package/dist/internal/cli-deploy.js +38 -14
- package/dist/internal/cli-mcp-oauth.d.ts.map +1 -1
- package/dist/internal/cli-mcp-oauth.js +15 -0
- package/dist/internal/cli-mcp.d.ts.map +1 -1
- package/dist/internal/cli-mcp.js +12 -0
- package/dist/internal/cli-slack.d.ts.map +1 -1
- package/dist/internal/cli-slack.js +8 -2
- package/dist/internal/cursor/credentials.d.ts +8 -2
- package/dist/internal/cursor/credentials.d.ts.map +1 -1
- package/dist/internal/cursor/credentials.js +27 -5
- package/dist/internal/deploy-client.d.ts +27 -0
- package/dist/internal/deploy-client.d.ts.map +1 -1
- package/dist/internal/deploy-client.js +32 -0
- package/dist/internal/deploy-manifest.d.ts +23 -0
- package/dist/internal/deploy-manifest.d.ts.map +1 -1
- package/dist/internal/deploy-manifest.js +84 -1
- package/dist/internal/describe-error.d.ts +1 -0
- package/dist/internal/describe-error.d.ts.map +1 -1
- package/dist/internal/describe-error.js +25 -0
- package/dist/internal/guest-network.d.ts +4 -10
- package/dist/internal/guest-network.d.ts.map +1 -1
- package/dist/internal/guest-network.js +42 -26
- package/dist/internal/hosted-admission-adapter.d.ts +2 -0
- package/dist/internal/hosted-admission-adapter.d.ts.map +1 -1
- package/dist/internal/hosted-catch-protocol.d.ts +51 -0
- package/dist/internal/hosted-catch-protocol.d.ts.map +1 -0
- package/dist/internal/hosted-catch-protocol.js +103 -0
- package/dist/internal/hosted-catch.d.ts +40 -0
- package/dist/internal/hosted-catch.d.ts.map +1 -0
- package/dist/internal/hosted-catch.js +149 -0
- package/dist/internal/hosted-delivery-protocol.d.ts +41 -0
- package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-delivery-protocol.js +249 -0
- package/dist/internal/hosted-delivery.d.ts +10 -1
- package/dist/internal/hosted-delivery.d.ts.map +1 -1
- package/dist/internal/hosted-delivery.js +100 -22
- package/dist/internal/hosted-execution-diag.d.ts +4 -1
- package/dist/internal/hosted-execution-diag.d.ts.map +1 -1
- package/dist/internal/hosted-execution-diag.js +13 -4
- package/dist/internal/hosted-execution-flush.d.ts +3 -0
- package/dist/internal/hosted-execution-flush.d.ts.map +1 -1
- package/dist/internal/hosted-execution-flush.js +2 -4
- package/dist/internal/http-control-plane-session.d.ts +30 -0
- package/dist/internal/http-control-plane-session.d.ts.map +1 -0
- package/dist/internal/http-control-plane-session.js +83 -0
- package/dist/internal/legacy-command-guard.d.ts +22 -0
- package/dist/internal/legacy-command-guard.d.ts.map +1 -0
- package/dist/internal/legacy-command-guard.js +51 -0
- package/dist/internal/platform-timers.d.ts +7 -0
- package/dist/internal/platform-timers.d.ts.map +1 -1
- package/dist/internal/platform-timers.js +139 -0
- package/dist/internal/reminder-control-plane-protocol.d.ts +2 -0
- package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
- package/dist/internal/reminder-control-plane-protocol.js +9 -2
- package/dist/internal/reminder-runner.d.ts +8 -0
- package/dist/internal/reminder-runner.d.ts.map +1 -1
- package/dist/internal/reminder-runner.js +36 -9
- package/dist/internal/resolve-prod-target.d.ts +2 -0
- package/dist/internal/resolve-prod-target.d.ts.map +1 -1
- package/dist/internal/resolve-prod-target.js +13 -0
- package/dist/internal/sdk-runner.d.ts.map +1 -1
- package/dist/internal/sdk-runner.js +4 -3
- package/dist/internal/server.d.ts.map +1 -1
- package/dist/internal/server.js +57 -56
- package/dist/internal/session-engine.d.ts +2 -6
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +95 -67
- package/dist/playground/assets/{index-Bq2HpEQB.js → index-BMDqAeXu.js} +28 -28
- package/dist/playground/assets/index-LUgJoWdL.css +1 -0
- package/dist/playground/index.html +2 -2
- package/dist/storage-backends/cursor-hosted.d.ts +6 -0
- package/dist/storage-backends/cursor-hosted.d.ts.map +1 -1
- package/dist/storage-backends/cursor-hosted.js +29 -1
- package/dist/types.d.ts +33 -5
- package/dist/types.d.ts.map +1 -1
- package/docs/README.md +4 -0
- package/docs/deployment.md +7 -2
- package/docs/evals.md +3 -2
- package/docs/guides/cloud-agents.md +4 -3
- package/docs/guides/github.md +2 -1
- package/docs/guides/grokbot-agents.md +2 -2
- package/docs/guides/improve.md +96 -0
- package/docs/guides/slack.md +2 -1
- package/docs/reference/agent-config.md +5 -2
- package/docs/reference/cli.md +18 -11
- package/docs/reference/connections.md +2 -1
- package/docs/reference/extensions.md +2 -0
- package/docs/scaffolding-agents.md +2 -1
- package/docs/troubleshooting.md +1 -1
- package/package.json +8 -1
- package/skills/create-agent/SKILL.md +1 -1
- package/skills/debug/SKILL.md +1 -1
- package/skills/evals/SKILL.md +1 -1
- package/skills/framework-map/SKILL.md +4 -2
- package/skills/github/SKILL.md +1 -1
- package/src/bin/agent-serve.ts +27 -2
- package/src/channels/github/github-channel.ts +8 -8
- package/src/channels/github/types.ts +5 -0
- package/src/channels/origin/origin-channel.ts +29 -13
- package/src/channels/origin/types.ts +5 -0
- package/src/channels.ts +157 -10
- package/src/connections.ts +2 -1
- package/src/extensions/improve/extension.ts +70 -0
- package/src/extensions/improve/skills/yourself.ts +50 -0
- package/src/internal/builtin-tools/artifacts.ts +2 -3
- package/src/internal/channel-route-dispatch.ts +66 -0
- package/src/internal/channel-state.ts +96 -0
- package/src/internal/cli-ax.ts +110 -1
- package/src/internal/cli-cursor.ts +4 -1
- package/src/internal/cli-deploy.ts +50 -10
- package/src/internal/cli-mcp-oauth.ts +18 -0
- package/src/internal/cli-mcp.ts +11 -0
- package/src/internal/cli-slack.ts +15 -2
- package/src/internal/cursor/credentials.ts +35 -7
- package/src/internal/deploy-client.ts +54 -0
- package/src/internal/deploy-manifest.ts +115 -1
- package/src/internal/describe-error.ts +28 -0
- package/src/internal/guest-network.ts +43 -29
- package/src/internal/hosted-admission-adapter.ts +2 -0
- package/src/internal/hosted-catch-protocol.ts +130 -0
- package/src/internal/hosted-catch.ts +192 -0
- package/src/internal/hosted-delivery-protocol.ts +387 -0
- package/src/internal/hosted-delivery.ts +155 -22
- package/src/internal/hosted-execution-diag.ts +21 -3
- package/src/internal/hosted-execution-flush.ts +6 -3
- package/src/internal/http-control-plane-session.ts +104 -0
- package/src/internal/legacy-command-guard.ts +59 -0
- package/src/internal/platform-timers.ts +191 -0
- package/src/internal/reminder-control-plane-protocol.ts +15 -2
- package/src/internal/reminder-runner.ts +60 -9
- package/src/internal/resolve-prod-target.ts +15 -0
- package/src/internal/sdk-runner.ts +2 -1
- package/src/internal/server.ts +89 -79
- package/src/internal/session-engine.ts +141 -83
- package/src/storage-backends/cursor-hosted.ts +40 -1
- package/src/types.ts +39 -6
- package/dist/docs/assets/chunks/@localSearchIndexroot.DXXZxiMv.js +0 -1
- package/dist/docs/assets/guides_cloud-agents.md.DS8RIjwx.js +0 -9
- package/dist/docs/assets/index.md.BW_6tOgR.js +0 -5
- package/dist/docs/assets/skills_framework-map.md.haibFyoB.js +0 -1
- package/dist/docs/assets/troubleshooting.md.Cus_YZga.js +0 -1
- package/dist/playground/assets/index-CZKKNlmb.css +0 -1
- /package/dist/docs/assets/{evals.md.CbMoebP1.lean.js → evals.md.C1ekS3k2.lean.js} +0 -0
- /package/dist/docs/assets/{guides_github.md.c0gdGJ-D.lean.js → guides_github.md.BH33UEBJ.lean.js} +0 -0
- /package/dist/docs/assets/{guides_grokbot-agents.md.DVqdhBKb.lean.js → guides_grokbot-agents.md.DyV-WArv.lean.js} +0 -0
- /package/dist/docs/assets/{index.md.BW_6tOgR.lean.js → index.md.BjH1w2ZW.lean.js} +0 -0
- /package/dist/docs/assets/{reference_agent-config.md.CHNpiyp4.lean.js → reference_agent-config.md.CvoL6pof.lean.js} +0 -0
- /package/dist/docs/assets/{reference_connections.md.Di6jJAXF.lean.js → reference_connections.md.BojkC6c5.lean.js} +0 -0
- /package/dist/docs/assets/{reference_extensions.md.CGmMLblt.lean.js → reference_extensions.md.CPWt00ds.lean.js} +0 -0
- /package/dist/docs/assets/{scaffolding-agents.md.em43xlY1.lean.js → scaffolding-agents.md.Kctn3OVb.lean.js} +0 -0
- /package/dist/docs/assets/{skills_create-agent.md.BVoWPcan.lean.js → skills_create-agent.md.Q3h6Je-e.lean.js} +0 -0
- /package/dist/docs/assets/{skills_evals.md.723kpUmA.lean.js → skills_evals.md.BhovOvrl.lean.js} +0 -0
- /package/dist/docs/assets/{skills_github.md.D0JahM8c.lean.js → skills_github.md.hgFX_oKY.lean.js} +0 -0
- /package/dist/docs/assets/{troubleshooting.md.Cus_YZga.lean.js → troubleshooting.md.CYEAO9bM.lean.js} +0 -0
package/dist/docs/llms-full.txt
CHANGED
|
@@ -660,7 +660,7 @@ exposes a stable URL while Cursor manages its runtime lifecycle.
|
|
|
660
660
|
### Before you deploy
|
|
661
661
|
|
|
662
662
|
- Confirm managed hosting is enabled for the account and team.
|
|
663
|
-
- Sign in
|
|
663
|
+
- Sign in as a team member, or use a team service-account API key with agent access.
|
|
664
664
|
- Add `@cursor/july` to the agent project.
|
|
665
665
|
|
|
666
666
|
For a GitHub source, install the Cursor GitHub App on the repository
|
|
@@ -689,6 +689,11 @@ Enter hostnames without schemes, ports, or paths. One leading `*.`
|
|
|
689
689
|
wildcard is allowed. Declared domains allow HTTPS and TLS traffic, not
|
|
690
690
|
arbitrary TCP ports.
|
|
691
691
|
|
|
692
|
+
The base policy already covers the hosts the platform itself uses: the
|
|
693
|
+
Cursor API (`api.cursor.com` and `api2.cursor.sh`), GitHub and GitLab,
|
|
694
|
+
the npm and Yarn registries, Slack, and Cursor's own artifact storage.
|
|
695
|
+
Declare a domain only for a host your own code reaches.
|
|
696
|
+
|
|
692
697
|
`secretNames` lists the environment variables the agent expects. Names
|
|
693
698
|
use `UPPER_SNAKE_CASE`. Commit names only; set their values after
|
|
694
699
|
creating the deployment. Names beginning with `CURSOR_` are reserved.
|
|
@@ -941,7 +946,7 @@ A self-hosted server can read these credentials.
|
|
|
941
946
|
|
|
942
947
|
| Credential | Used for | Provide it as |
|
|
943
948
|
| --- | --- | --- |
|
|
944
|
-
| Cursor API key | model turns, cloud runtime, Cursor account MCP connections | `agent-sdk login` (stores a revocable key), `CURSOR_API_KEY`, or `--api-key` / `serve({ apiKey })` |
|
|
949
|
+
| Cursor API key | model turns, cloud runtime, Cursor account MCP connections | `agent-sdk login` (stores a revocable key), `CURSOR_API_KEY`, `CURSOR_SERVICE_ACCOUNT_KEY`, or `--api-key` / `serve({ apiKey })` |
|
|
945
950
|
| Slack tokens | Slack channels | `<PREFIX>_SLACK_BOT_TOKEN` + `<PREFIX>_SLACK_APP_TOKEN` per agent |
|
|
946
951
|
| GitHub webhook secret | delivery signature verification | `GITHUB_WEBHOOK_SECRET`, same value on server and signer |
|
|
947
952
|
| GitHub API | outbound API calls | a GitHub App (`GITHUB_APP_ID` + `GITHUB_APP_PRIVATE_KEY` + installation id) or `GITHUB_TOKEN` / `gh auth login` |
|
|
@@ -3538,8 +3543,9 @@ keep live progress off stderr. A TTY streams turn progress by default.
|
|
|
3538
3543
|
`--verbose` still writes `t.log` lines to stderr and adds reply snippets
|
|
3539
3544
|
to text results.
|
|
3540
3545
|
|
|
3541
|
-
Model turns need a Cursor credential
|
|
3542
|
-
`CURSOR_API_KEY
|
|
3546
|
+
Model turns need a Cursor credential: `CURSOR_API_KEY`, then
|
|
3547
|
+
`CURSOR_API_KEY_FILE` (hosted default `/run/cursor/secrets/CURSOR_API_KEY`), then
|
|
3548
|
+
`CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`.
|
|
3543
3549
|
|
|
3544
3550
|
See [CLI: eval](/docs/reference/cli.md#eval) for flags and exit codes.
|
|
3545
3551
|
|
|
@@ -3849,9 +3855,10 @@ export default cursorCloudAgents({
|
|
|
3849
3855
|
});
|
|
3850
3856
|
```
|
|
3851
3857
|
|
|
3852
|
-
Launches run under the host's signed-in account (`agent-sdk login
|
|
3853
|
-
`CURSOR_API_KEY`) and spend its
|
|
3854
|
-
repositories the agent may target, and
|
|
3858
|
+
Launches run under the host's signed-in account (`agent-sdk login`,
|
|
3859
|
+
`CURSOR_API_KEY`, or `CURSOR_SERVICE_ACCOUNT_KEY`) and spend its
|
|
3860
|
+
cloud-agent budget. Name the repositories the agent may target, and
|
|
3861
|
+
keep approval on when you can't.
|
|
3855
3862
|
|
|
3856
3863
|
Mount it on an agent that runs on the local runtime; that is where
|
|
3857
3864
|
launches park for approval. On the cloud runtime approvals don't
|
|
@@ -4105,7 +4112,8 @@ The companion skill for coding agents is
|
|
|
4105
4112
|
Connect GitHub in Cursor for the repositories you care about (Settings or
|
|
4106
4113
|
[cursor.com/dashboard](https://cursor.com/dashboard)). That gives your
|
|
4107
4114
|
account access and lets Cursor receive the repo's webhooks. Sign the host
|
|
4108
|
-
in (`agent-sdk login
|
|
4115
|
+
in (`agent-sdk login`, `CURSOR_API_KEY`, or
|
|
4116
|
+
`CURSOR_SERVICE_ACCOUNT_KEY`), then opt the channel into the
|
|
4109
4117
|
Cursor account connection:
|
|
4110
4118
|
|
|
4111
4119
|
```ts
|
|
@@ -4403,8 +4411,8 @@ export default cursorGrokBotAgents({
|
|
|
4403
4411
|
|
|
4404
4412
|
`agents` is the allowlist. List every Grok Bot the model may talk to;
|
|
4405
4413
|
a name outside the list is refused. Calls run under the host's
|
|
4406
|
-
signed-in account (`agent-sdk login
|
|
4407
|
-
approval on when you can't.
|
|
4414
|
+
signed-in account (`agent-sdk login`, `CURSOR_API_KEY`, or
|
|
4415
|
+
`CURSOR_SERVICE_ACCOUNT_KEY`). Keep approval on when you can't.
|
|
4408
4416
|
|
|
4409
4417
|
Start from the [Grok Bot agents template](/docs/templates/grokbot-agents.md)
|
|
4410
4418
|
when you want a project that already mounts this.
|
|
@@ -4596,6 +4604,102 @@ Continue with these pages:
|
|
|
4596
4604
|
|
|
4597
4605
|
---
|
|
4598
4606
|
|
|
4607
|
+
Source: /docs/guides/improve.md
|
|
4608
|
+
|
|
4609
|
+
# Self-improvement
|
|
4610
|
+
|
|
4611
|
+
The `improve` extension lets an agent change how it behaves by changing
|
|
4612
|
+
its own source. Someone asks it to answer more briefly, to stop reaching
|
|
4613
|
+
for a tool, or to learn a procedure. The agent writes a brief, a one-off
|
|
4614
|
+
Cursor cloud agent makes the change on a branch and opens a pull
|
|
4615
|
+
request, and the agent reports that pull request. Nothing changes until
|
|
4616
|
+
a person reviews it and deploys.
|
|
4617
|
+
|
|
4618
|
+
The tree the agent runs from is never edited; nothing changed there
|
|
4619
|
+
survives a deploy. The pull request is the only path.
|
|
4620
|
+
|
|
4621
|
+
## Mount it
|
|
4622
|
+
|
|
4623
|
+
The extension ships with `@cursor/july`. It relies on a
|
|
4624
|
+
[`cursor-cloud-agents`](/docs/guides/cloud-agents.md) mount beside it, with the
|
|
4625
|
+
agent's own repository among its `cloud.repos`.
|
|
4626
|
+
|
|
4627
|
+
```ts
|
|
4628
|
+
// agent/extensions/cloud.ts
|
|
4629
|
+
import cursorCloudAgents from "@cursor/july/extensions/cursor-cloud-agents";
|
|
4630
|
+
|
|
4631
|
+
export default cursorCloudAgents({
|
|
4632
|
+
cloud: {
|
|
4633
|
+
repos: [{ url: "https://github.com/acme/agents", startingRef: "main" }],
|
|
4634
|
+
},
|
|
4635
|
+
});
|
|
4636
|
+
```
|
|
4637
|
+
|
|
4638
|
+
```ts
|
|
4639
|
+
// agent/extensions/improve.ts
|
|
4640
|
+
import improve from "@cursor/july/extensions/improve";
|
|
4641
|
+
|
|
4642
|
+
export default improve({
|
|
4643
|
+
repo: "https://github.com/acme/agents",
|
|
4644
|
+
path: "agents/concierge",
|
|
4645
|
+
});
|
|
4646
|
+
```
|
|
4647
|
+
|
|
4648
|
+
`repo` is the repository that holds the agent's source and `path` is
|
|
4649
|
+
the agent's directory in it, the same values `agent-sdk deploy --repo`
|
|
4650
|
+
and `--path` take. Mount it as `improve`: the skill then reads
|
|
4651
|
+
`improve__yourself`, which is what a person asks for.
|
|
4652
|
+
|
|
4653
|
+
An agent on the
|
|
4654
|
+
[cloud runtime](/docs/reference/agent-config.md#choose-a-runtime) already
|
|
4655
|
+
runs each turn on a VM with the repository checked out. It mounts
|
|
4656
|
+
`improve` alone, and the skill has it branch in that checkout instead of
|
|
4657
|
+
launching a second agent.
|
|
4658
|
+
|
|
4659
|
+
## What the agent does
|
|
4660
|
+
|
|
4661
|
+
With the extension mounted, "change how you work" becomes a procedure:
|
|
4662
|
+
|
|
4663
|
+
- **Locate the change.** The skill maps the ask onto the Agent SDK tree:
|
|
4664
|
+
instructions for the always-on prompt, a skill for a procedure, a tool
|
|
4665
|
+
for behavior that must be right every time, `agent.ts` for the model.
|
|
4666
|
+
- **Brief a cloud agent.** The agent writes a self-contained brief: who
|
|
4667
|
+
is asking and why, the repository, ref, and path, the files it expects
|
|
4668
|
+
to change, your notes about the tree, and the rules. Follow the
|
|
4669
|
+
repository's conventions, keep the diff to the change, run the
|
|
4670
|
+
repository's checks, open a pull request against the deployed ref,
|
|
4671
|
+
never merge.
|
|
4672
|
+
- **Follow up and report.** It gives the person the cloud agent's URL,
|
|
4673
|
+
checks on the run, reads the pull request before repeating its claims,
|
|
4674
|
+
and reports the pull request, not the delegation. It says the change
|
|
4675
|
+
takes effect at the next deploy, never that it has changed already.
|
|
4676
|
+
|
|
4677
|
+
Ask it directly. "Improve yourself: stop opening with a summary" is
|
|
4678
|
+
enough.
|
|
4679
|
+
|
|
4680
|
+
## Configure it
|
|
4681
|
+
|
|
4682
|
+
| Option | What it controls |
|
|
4683
|
+
| --- | --- |
|
|
4684
|
+
| `repo` | The repository holding the agent's source. One of the cloud mount's `cloud.repos`. |
|
|
4685
|
+
| `path` | The agent's directory in the repository, as `agent-sdk deploy --path` names it. |
|
|
4686
|
+
| `ref` | The ref the deployment tracks. Branches start there and pull requests target it. Defaults to `main`. |
|
|
4687
|
+
| `notes` | What a coding agent must know about this tree beyond the standard layout: a house skill format, a manifest that forces a reinstall, a pull request convention. Copied into every brief. |
|
|
4688
|
+
| `deploy` | Who deploys a merged change and when it is live. Defaults to "It takes effect at the next deploy." |
|
|
4689
|
+
|
|
4690
|
+
## What's next
|
|
4691
|
+
|
|
4692
|
+
Continue with these pages:
|
|
4693
|
+
|
|
4694
|
+
- [Cursor cloud agents](/docs/guides/cloud-agents.md): the mount that does the
|
|
4695
|
+
coding, and how to gate its launches
|
|
4696
|
+
- [Extensions](/docs/reference/extensions.md): how mounts, namespaces, and
|
|
4697
|
+
overrides work
|
|
4698
|
+
- [Deployment](/docs/deployment.md): how a merged change reaches the
|
|
4699
|
+
running agent
|
|
4700
|
+
|
|
4701
|
+
---
|
|
4702
|
+
|
|
4599
4703
|
Source: /docs/guides/mcp-oauth.md
|
|
4600
4704
|
|
|
4601
4705
|
# Host MCP OAuth
|
|
@@ -5154,7 +5258,8 @@ agent-sdk slack create --dir .
|
|
|
5154
5258
|
agent-sdk slack create --dir . --prod
|
|
5155
5259
|
```
|
|
5156
5260
|
|
|
5157
|
-
Sign in first (`agent-sdk login` or `CURSOR_API_KEY`).
|
|
5261
|
+
Sign in first (`agent-sdk login` or `CURSOR_API_KEY`). A team
|
|
5262
|
+
service-account key cannot create Slack apps. Finish **Add
|
|
5158
5263
|
Slack to this agent** as the same Cursor account. Then run
|
|
5159
5264
|
`agent-sdk slack doctor --prefix MY_AGENT` and serve:
|
|
5160
5265
|
|
|
@@ -5882,6 +5987,7 @@ npx @cursor/july docs
|
|
|
5882
5987
|
| Driving PRs from a cloud VM | [PR autofixer template](/docs/templates/pr-autofixer.md) |
|
|
5883
5988
|
| Handing coding work to Cursor cloud agents | [Cursor cloud agents](/docs/guides/cloud-agents.md) |
|
|
5884
5989
|
| Talking to your Grok Bot agents | [Cursor Grok Bot agents](/docs/guides/grokbot-agents.md) |
|
|
5990
|
+
| Letting an agent change its own source | [Self-improvement](/docs/guides/improve.md) |
|
|
5885
5991
|
| Driving an agent from Linear (or another tracker) | [Webhooks guide: Linear example](/docs/guides/webhooks.md#example-linear-as-the-control-plane) |
|
|
5886
5992
|
| Making an existing agent measurably better | [Evals](/docs/evals.md), then [Hillclimbing](/docs/hillclimbing.md) |
|
|
5887
5993
|
| Comparing variants on live traffic | [Live A/B metrics](/docs/ab.md) |
|
|
@@ -5952,6 +6058,9 @@ npx @cursor/july docs
|
|
|
5952
6058
|
and steer cloud agents through the `cursor-cloud-agents` extension.
|
|
5953
6059
|
- [Cursor Grok Bot agents](/docs/guides/grokbot-agents.md): let the agent
|
|
5954
6060
|
talk to Grok Bot agents through the `cursor-grokbot-agents` extension.
|
|
6061
|
+
- [Self-improvement](/docs/guides/improve.md): let the agent change its own
|
|
6062
|
+
source through a one-off cloud agent and a pull request with the
|
|
6063
|
+
`improve` extension.
|
|
5955
6064
|
- [OpenTelemetry](/docs/guides/opentelemetry.md): push session, turn, and
|
|
5956
6065
|
tool traces to an OTLP collector you run.
|
|
5957
6066
|
|
|
@@ -6613,8 +6722,11 @@ console.log(`listening on ${handle.url}`);
|
|
|
6613
6722
|
Host settings match the documented [CLI](/docs/reference/cli.md) `serve` flags.
|
|
6614
6723
|
`serve()` also accepts `discovery` (project-loading options) and
|
|
6615
6724
|
`mode: "single" | "multi"`. The Cursor credential resolves in one order
|
|
6616
|
-
everywhere: explicit `apiKey`, then `CURSOR_API_KEY`, then
|
|
6617
|
-
|
|
6725
|
+
everywhere: explicit `apiKey`, then `CURSOR_API_KEY`, then
|
|
6726
|
+
`CURSOR_API_KEY_FILE` (hosted default `/run/cursor/secrets/CURSOR_API_KEY`
|
|
6727
|
+
when unset), then `CURSOR_SERVICE_ACCOUNT_KEY`, then the key stored by
|
|
6728
|
+
`agent-sdk login`. On a host that has both the service-account key and a
|
|
6729
|
+
bind file, the file principal wins.
|
|
6618
6730
|
|
|
6619
6731
|
## What's next
|
|
6620
6732
|
|
|
@@ -7122,7 +7234,7 @@ the agent project. Slugged mounts get a subdirectory named for the slug.
|
|
|
7122
7234
|
| `--host` | Bind this host. The default is loopback-only `127.0.0.1`. |
|
|
7123
7235
|
| `--dev` | Disable automatic schedule and reminder firing, admit unsigned loopback GitHub deliveries, and widen playground session access on loopback. |
|
|
7124
7236
|
| `--mode` | Use `multi` for slugged routes and an index, or `single` for one agent at the unslugged `/v1/*`. The default is `multi`. |
|
|
7125
|
-
| `--api-key` | Use this Cursor API key.
|
|
7237
|
+
| `--api-key` | Use this Cursor API key. Otherwise the command uses `CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE` (hosted default `/run/cursor/secrets/CURSOR_API_KEY` when unset), then `CURSOR_SERVICE_ACCOUNT_KEY`, then the stored login. |
|
|
7126
7238
|
| `--state-root` | Store sessions, streams, workspaces, and channel state here. Keep durable production state outside the agent repository. |
|
|
7127
7239
|
| `--bearer-token` | Require this bearer token on routes without authored auth. Mutually exclusive with `--allow-anonymous`. |
|
|
7128
7240
|
| `--allow-anonymous` | Admit every caller as one `anonymous` principal. Use only behind a trusted network boundary. |
|
|
@@ -7570,10 +7682,14 @@ runtime, and Cursor account MCP connections. `--key-name` changes the
|
|
|
7570
7682
|
name of a browser-minted key. `login --api-key` validates and stores a
|
|
7571
7683
|
key you already created.
|
|
7572
7684
|
|
|
7573
|
-
`whoami` shows which credential is active and why.
|
|
7574
|
-
|
|
7575
|
-
|
|
7576
|
-
|
|
7685
|
+
`whoami` shows which credential is active and why. An explicit key
|
|
7686
|
+
wins, then `CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE` (hosted default
|
|
7687
|
+
`/run/cursor/secrets/CURSOR_API_KEY` when unset), then
|
|
7688
|
+
`CURSOR_SERVICE_ACCOUNT_KEY`, then the stored login. A host that has
|
|
7689
|
+
both the service-account key and a bind file authenticates as the file
|
|
7690
|
+
principal. `logout` removes the local credential file but doesn't
|
|
7691
|
+
revoke the API key. Revoke it in the Cursor dashboard when it should
|
|
7692
|
+
stop working.
|
|
7577
7693
|
|
|
7578
7694
|
Login and account RPCs honor `CURSOR_API_BASE_URL`. The SDK harness
|
|
7579
7695
|
honors `CURSOR_BACKEND_URL`. Set both to the same URL, or keys minted
|
|
@@ -7611,9 +7727,9 @@ agent-sdk deploy [--dir <path>] [--slug <slug> | --all] [--team <id>]
|
|
|
7611
7727
|
[--no-wait] [--json]
|
|
7612
7728
|
```
|
|
7613
7729
|
|
|
7614
|
-
Managed hosting requires team
|
|
7615
|
-
|
|
7616
|
-
team.
|
|
7730
|
+
Managed hosting requires team membership and the team's cloud-agent
|
|
7731
|
+
entitlement. A team service-account API key with agent access can
|
|
7732
|
+
deploy. `--team` defaults to the signed-in account's team.
|
|
7617
7733
|
|
|
7618
7734
|
For a single project, the slug defaults to a normalized version of the
|
|
7619
7735
|
directory name. Deployment slugs contain lowercase letters, digits, `_`,
|
|
@@ -7856,8 +7972,9 @@ checklist. It doesn't change files.
|
|
|
7856
7972
|
`slack create` opens the signed-in Cursor dashboard wizard. Finish Slack
|
|
7857
7973
|
consent and the bot name there. The CLI writes the token pair into
|
|
7858
7974
|
`<dir>/.env.local` and runs `doctor`. It requires a signed-in host
|
|
7859
|
-
(`agent-sdk login` or `CURSOR_API_KEY`).
|
|
7860
|
-
|
|
7975
|
+
(`agent-sdk login` or `CURSOR_API_KEY`). A team service-account key
|
|
7976
|
+
cannot create Slack apps. `--prod` provisions the production app; the
|
|
7977
|
+
default is the development app. `--name` / `--icon`
|
|
7861
7978
|
/ `--channel-posts` prefill the wizard. A second create for the same
|
|
7862
7979
|
slug and env overwrites the live Slack app. If Slack needs a workspace
|
|
7863
7980
|
admin's approval, the wizard waits; keep the CLI running, open Slack's
|
|
@@ -7970,7 +8087,9 @@ These environment variables affect the CLI and its channel packs.
|
|
|
7970
8087
|
|
|
7971
8088
|
| Variable | Meaning |
|
|
7972
8089
|
| --- | --- |
|
|
7973
|
-
| `CURSOR_API_KEY` | Cursor credential. It takes precedence over the stored login. |
|
|
8090
|
+
| `CURSOR_API_KEY` | Cursor credential. It takes precedence over `CURSOR_API_KEY_FILE`, `CURSOR_SERVICE_ACCOUNT_KEY`, and the stored login. |
|
|
8091
|
+
| `CURSOR_API_KEY_FILE` | Path to a Cursor credential file. Used when `CURSOR_API_KEY` is unset. When this variable is unset, the hosted default `/run/cursor/secrets/CURSOR_API_KEY` is tried. A present file takes precedence over `CURSOR_SERVICE_ACCOUNT_KEY` and the stored login. |
|
|
8092
|
+
| `CURSOR_SERVICE_ACCOUNT_KEY` | Team service-account credential. Used when `CURSOR_API_KEY` and `CURSOR_API_KEY_FILE` (including the hosted default path) are unset. It takes precedence over the stored login. |
|
|
7974
8093
|
| `CURSOR_API_BASE_URL` | Backend used by login, account, deployment, and event-relay RPCs. |
|
|
7975
8094
|
| `CURSOR_BACKEND_URL` | Backend used by the Cursor SDK harness. |
|
|
7976
8095
|
| `AGENT_SERVE_CONFIG_DIR` | Directory for stored credentials and update-check state. Defaults to the CLI config directory under `~/.config`. |
|
|
@@ -8212,7 +8331,8 @@ Name the file `account.ts`. `cursor.ts` collides with the IDE `cursor`
|
|
|
8212
8331
|
MCP namespace. `advertiseTools: true` puts connector tools on local
|
|
8213
8332
|
turns by name. Without it they sit behind harness meta-tools.
|
|
8214
8333
|
|
|
8215
|
-
The host must be signed in (`agent-sdk login` or
|
|
8334
|
+
The host must be signed in (`agent-sdk login`, `CURSOR_API_KEY`, or
|
|
8335
|
+
`CURSOR_SERVICE_ACCOUNT_KEY`).
|
|
8216
8336
|
`serve` fails fast at startup otherwise, and logs each connector's live
|
|
8217
8337
|
status (`connected`, `needsAuth`, `error`) as it starts.
|
|
8218
8338
|
|
|
@@ -8559,6 +8679,8 @@ Continue with these pages:
|
|
|
8559
8679
|
lets an agent launch and steer cloud agents
|
|
8560
8680
|
- [Cursor Grok Bot agents](/docs/guides/grokbot-agents.md): the extension
|
|
8561
8681
|
that lets an agent talk to Grok Bot agents
|
|
8682
|
+
- [Self-improvement](/docs/guides/improve.md): the extension that lets an
|
|
8683
|
+
agent change its own source through a cloud agent and a pull request
|
|
8562
8684
|
- [Tools](/docs/reference/tools.md): the tool contract extensions contribute to
|
|
8563
8685
|
- [Skills](/docs/reference/skills.md): the skill forms an extension can carry
|
|
8564
8686
|
- [Project layout](/docs/reference/project-layout.md): where `agent/extensions/` sits
|
|
@@ -10516,7 +10638,8 @@ Cursor checks the project in this order:
|
|
|
10516
10638
|
|
|
10517
10639
|
Validation, discovery, direct server-tool calls, and server startup work
|
|
10518
10640
|
without a Cursor credential. Model turns and evals need
|
|
10519
|
-
`CURSOR_API_KEY`
|
|
10641
|
+
`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE` (hosted default `/run/cursor/secrets/CURSOR_API_KEY`), then `CURSOR_SERVICE_ACCOUNT_KEY`, then a saved
|
|
10642
|
+
`agent-sdk login`.
|
|
10520
10643
|
|
|
10521
10644
|
## What happens after the first agent works?
|
|
10522
10645
|
|
|
@@ -10722,7 +10845,7 @@ npx tsc --noEmit -p ./<slug>
|
|
|
10722
10845
|
tsx does not typecheck. Tool `execute` must return JSON-shaped
|
|
10723
10846
|
values: object literals or `type` aliases, not `interface` types.
|
|
10724
10847
|
|
|
10725
|
-
Model turns need `CURSOR_API_KEY
|
|
10848
|
+
Model turns need a Cursor credential (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`). Without one, finish the
|
|
10726
10849
|
key-free checks, confirm `run` fails with only the API-key error,
|
|
10727
10850
|
and hand these over:
|
|
10728
10851
|
|
|
@@ -10788,7 +10911,7 @@ Local `agent-sdk serve`. Hosted start or health failures:
|
|
|
10788
10911
|
| `403` on stream | Wrong principal. Same auth as create; beyond loopback send `--bearer-token`. |
|
|
10789
10912
|
| Works on loopback, blocked via tunnel | `localDevStrict()` rejects forwarded headers. Use `--bearer-token`. Never `--allow-anonymous` with account MCP. |
|
|
10790
10913
|
| Slack `channel idle … missing credentials` | Expected. `slack doctor --prefix <PREFIX>`. |
|
|
10791
|
-
| Immediate API-key error | Model turns need `CURSOR_API_KEY
|
|
10914
|
+
| Immediate API-key error | Model turns need a Cursor credential (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`). |
|
|
10792
10915
|
| Approvals or sandbox seeds missing | `runtime: "cloud"`. Those are local only. `validate` warns. |
|
|
10793
10916
|
| `validate` clean, CI typecheck fails | tsx skipped types. JSON-shaped returns; `type` not `interface`. |
|
|
10794
10917
|
|
|
@@ -10823,7 +10946,7 @@ agent-sdk eval --dir . --tag smoke
|
|
|
10823
10946
|
| `evals/weather.eval.ts` + `{ id: "nyc" }` | `weather/nyc` |
|
|
10824
10947
|
|
|
10825
10948
|
`eval` boots an ephemeral server and a temp state root. `--url`
|
|
10826
|
-
points at a running agent. Model turns need `CURSOR_API_KEY
|
|
10949
|
+
points at a running agent. Model turns need a Cursor credential (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`).
|
|
10827
10950
|
|
|
10828
10951
|
## Seeding
|
|
10829
10952
|
|
|
@@ -10927,8 +11050,10 @@ Public docs: `node_modules/@cursor/july/dist/docs/llms.txt` or
|
|
|
10927
11050
|
per-project cache directory under `~/.cache`. Point cwd at a
|
|
10928
11051
|
checkout only when the agent must inherit that tree.
|
|
10929
11052
|
5. **Attached MCP is nameless** until `advertiseTools: true`.
|
|
10930
|
-
6. **Model turns need
|
|
10931
|
-
|
|
11053
|
+
6. **Model turns need a Cursor credential** (`CURSOR_API_KEY`, then
|
|
11054
|
+
`CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then
|
|
11055
|
+
`agent-sdk login`). `validate`,
|
|
11056
|
+
`info`, `call`, and `serve` bring-up do not.
|
|
10932
11057
|
|
|
10933
11058
|
## Folder structure
|
|
10934
11059
|
|
|
@@ -11049,7 +11174,7 @@ at deploy. Repos must share one GitHub owner.
|
|
|
11049
11174
|
|
|
11050
11175
|
| Source | When |
|
|
11051
11176
|
| --- | --- |
|
|
11052
|
-
| `cursorAccount` + `serve --cursor-events` | Preferred. Signed-in host (`agent-sdk login`
|
|
11177
|
+
| `cursorAccount` + `serve --cursor-events` | Preferred. Signed-in host (`agent-sdk login`, `CURSOR_API_KEY`, or `CURSOR_SERVICE_ACCOUNT_KEY`). Repos from the channel and from repeatable `--repo owner/name`. Cap 20, one GitHub owner |
|
|
11053
11178
|
| HTTP `POST /<slug>/v1/channels/github` with a webhook secret | `allowAll()` + `X-Hub-Signature-256` |
|
|
11054
11179
|
| HTTP, no secret | Loopback only. `serve --dev` also admits unsigned loopback (fixtures / forward) |
|
|
11055
11180
|
|
|
@@ -12507,7 +12632,7 @@ not on `PATH`, use `npx @cursor/july`.
|
|
|
12507
12632
|
| What you see | What to do |
|
|
12508
12633
|
| --- | --- |
|
|
12509
12634
|
| Built-in file reads and greps fail; the turn retries for a long time | Run under Node 22.13+ (or `tsx`), never Bun. Look for `NGHTTP2_FRAME_SIZE_ERROR` in logs. |
|
|
12510
|
-
| The turn fails immediately with an API-key error | Sign in with `agent-sdk login`, or set `CURSOR_API_KEY`. Discovery, `info`, `call`, and serve bring-up work without a key; model turns need one. |
|
|
12635
|
+
| The turn fails immediately with an API-key error | Sign in with `agent-sdk login`, or set `CURSOR_API_KEY` or `CURSOR_SERVICE_ACCOUNT_KEY`. Discovery, `info`, `call`, and serve bring-up work without a key; model turns need one. |
|
|
12511
12636
|
| Replies quote rules or `AGENTS.md` from outside your agent project | The session workspace inherited parent-folder config. Nested git checkouts default `local.cwd` to a per-project cache directory under `~/.cache`. Point `defineAgent({ local: { cwd } })` at a checkout only when the agent should inherit that tree, or set `--state-root` to a clean directory (for example under `/tmp`). |
|
|
12512
12637
|
| Yellow box shows Datadog/Linear tools, but the model lists `GetDynamicTools` / IDE `cursor` tools and never calls them | Attached MCP sits behind harness meta-tools, or the harness cwd is still inside another checkout. Set `advertiseTools: true` for named tools on local turns. Check `GET /v1/info` `local.cwd` and `connections[].advertiseTools`. |
|
|
12513
12638
|
| Server tools, skills, or workspace seed files never appear | Server tools and sandbox seeds apply on the local runtime (cloud server tools need `--public-url` / `--cloud-tools-url`). Skills reach cloud through the Agent Store when hosting or a personal `CURSOR_API_KEY` is available; otherwise only skills already in the cloud repo. `validate` warns when this combination is present. |
|
package/dist/docs/llms.txt
CHANGED
|
@@ -41,6 +41,7 @@
|
|
|
41
41
|
- [GitHub](/docs/guides/github.md): Wake your agent from pull requests, CI, and comments by pulling Cursor SCM events, with fixtures and replay for local tests.
|
|
42
42
|
- [Cursor Grok Bot agents](/docs/guides/grokbot-agents.md): Let an agent-sdk agent talk to your Grok Bot agents: mount the extension, name the bots it may reach, and decide what needs approval.
|
|
43
43
|
- [Human-in-the-loop](/docs/guides/human-in-the-loop.md): Gate a tool call on human approval: park it, resolve it from the playground, HTTP, or Slack, and keep the turn alive throughout.
|
|
44
|
+
- [Self-improvement](/docs/guides/improve.md): Mount improve so an agent can change its own instructions, skills, and tools through a pull request a one-off cloud agent opens.
|
|
44
45
|
- [Host MCP OAuth](/docs/guides/mcp-oauth.md): Authorize defineConnection({ url, oauth: true }) with agent-sdk mcp oauth, store tokens locally, and push MCP_OAUTH_* secrets to hosted deployments.
|
|
45
46
|
- [OpenTelemetry](/docs/guides/opentelemetry.md): Push session, turn, and tool traces from the serve process to an OTLP collector you run.
|
|
46
47
|
- [Slack](/docs/guides/slack.md): Run a Socket Mode Slack bot from the dashboard wizard, or import an app you own.
|