@kody/cursorFork

@kody/cursor

Official Cursor cube mark on black. Cursor® is a trademark of Anysphere, Inc. This package is not affiliated with or endorsed by Anysphere.

Share this listing as https://kody.codes/@kody/cursor

Intent

SDK for the Cursor Cloud Agents API. Transport is one compact authenticated request helper against https://api.cursor.com (Bearer cursorApiKey). Domain modules cover agent lifecycle, artifact download shaping, run stream parsing, and GitHub PR enrichment. Use ./request for any unwrapped path (Enterprise Admin, Analytics, AI-Code-Tracking, Bugbot, etc.).

No public Cursor OpenAPI document was available for scaffolding; plumbing is intentionally thin rather than hand-rolled per endpoint.

This listing is meant to be forked. After you fork, save your cursorApiKey and call the helpers in your account. No personal agent ids, repos, or API keys are baked in.

What it does

• Launch or manage Cursor Cloud Agents (create, list, follow-up runs, artifacts)
• Inspect fleet/worker utilization for self-hosted pools
• Discover models and accessible GitHub repositories before creating agents
• Call unwrapped Cursor API endpoints via cursorRequest

Prerequisites / setup

Cursor has no built-in Kody OAuth app. Auth is a saved Cloud Agents API key. Do not paste the key into chat.

1. Create an API key at cursor.com/dashboard → API Keys (key only, not an Authorization header). Cursor accepts Basic (API_KEY:) or Bearer; this package uses Bearer.
2. Save it in Kody:

https://kody.codes/account/secrets/new?name=cursorApiKey&description=Cursor%20Cloud%20Agents%20API%20key%20(Bearer%20token%20for%20api.cursor.com)&allowedHosts=api.cursor.com&scope=user

3. In the account secrets UI, approve host api.cursor.com. Saving the secret does not approve hosts by itself.

Optional, only for agentsWithOpenGithubPrs:

https://kody.codes/account/secrets/new?name=githubPersonalAccessToken&description=GitHub%20personal%20access%20token%20for%20open%20PR%20enrichment&allowedHosts=api.github.com&scope=user

Agents: see AGENTS.md for import paths and smoke checks.

Done when

• cursorApiKey is saved; host and package secret access are approved
• Read-only apiKeyInfo (./me) returns key metadata
• You can create an agent / run and list models when needed

Docs

• Cursor API overview
• Background agent endpoints