Cursor 昨天放出了一个重磅仓库:cursor/cookbook,目前 1.1k Stars、129 Forks。这是一个 TypeScript 示例库,展示了如何用 Cursor SDK 构建自己的 AI 编程工具和应用。
Cursor SDK 是什么
简单说,Cursor SDK 是 Cursor 官方提供的 TypeScript API,允许你从自己的应用、脚本和工作流里调用 Cursor 的编码 Agent。它有几个核心能力:
- 支持本地工作区和云端运行时的同一套 Agent
- 流式传输运行事件,实时看到 Agent 在做什么
- 从代码层面管理提示词、模型、取消操作、产物(Artifacts)和对话状态
也就是说不只是在 Cursor IDE 里用它,而是把 Cursor 的 Agent 能力做成可调用的基础设施。
四个示例
Cookbook 包含四个从易到难的示例:
Quickstart — 最小示例,创建一个本地 Agent,发送一个提示词,流式输出响应。需要 Node.js 22+。适合快速体验 SDK 能做什么。
App Builder — 一个完整的 Web 应用,在沙盒云环境中启动 Agent 来快速搭建项目并迭代想法。展示了一个端到端循环:收集 API key → 创建隔离的预览工作区 → 流式传输 Agent 响应 → 在 iframe 里预览生成的 UI → 管理多个对话。技术栈是 Next.js。
Agent Kanban — 一个 Linear 风格的看板,用来管理 Cursor Cloud Agents。可以按状态、仓库、分支或创建日期分组,支持查看状态元数据、最新活动、PR 链接和产物预览,还能直接从看板创建新的 Cloud Agents。
Coding Agent CLI — 命令行工具,支持本地和云端两种执行模式,提供交互式 TUI。TUI 里可以用 / 打开命令菜单,切换模式、选模型、重置会话。用 Bun 1.3+ 开发。
怎么用
从 Cursor integrations dashboard 获取 API key,设置环境变量 CURSOR_API_KEY,clone 仓库,按具体示例安装依赖运行即可。
更多信息在 Cursor SDK TypeScript 文档。
Cookbook 的出现说明一件事:Cursor 不只是做一个 IDE,它在把 AI 编程能力通过 SDK 开放出来,让开发者在上面构建自己的工具和应用。这是一个生态打法——把 Agent 能力做成可组合的 building blocks,谁都能拿来二次开发。对想做 AI 编程工具的人来说,这是目前最低成本的入局机会。