用途：cursor-cli 提供 agent 命令行工具，与 SDK、编辑器共用同一 agent 运行时。当 shell 脚本的易用性优于 TypeScript 程序时选用 CLI；需要流式事件、持久云端重连或编程式子代理时选用 SDK。
主要能力：支持交互式 agent REPL，包含 Agent / Plan / Ask 三种模式，可通过 --mode 或 Shift+Tab 切换；支持会话恢复（agent resume、agent --continue）；支持以 & 前缀进行后台云端交接。无头模式提供 -p / --print，以及 --force / --yolo；输出格式支持 text / json / stream-json，并可用 --stream-partial-output；退出码可通过 shell 中的 $? 获取。CI 方面提供 GitHub Actions 集成（工作流片段、CURSOR_API_KEY secret）以及限制 agent 自主性的权限配置。
使用方式：安装与认证参见 references/install（curl / PowerShell 安装器，$HOME/.cursor/bin）和 references/auth（CURSOR_API_KEY、登录流程）。交互、模式、会话、云端交接、无头、输出格式、退出码、GitHub Actions、权限等细节分别见对应 references 页面。
适用场景：终端中的一次性提示；对仓库执行操作的 CI / GitHub Actions 任务；带结构化输出的无头脚本化运行；在提升为 SDK 代码前的快速本地实验。
限制：资料未提供具体安装命令、完整参数列表、价格、平台支持范围或效果说明，这些内容暂未提供。