核心用法
Cursor CLI Agent 是 Cursor 官方推出的命令行 AI 编程助手，提供交互式与非交互式两种工作模式。
交互式模式：通过 agent 启动会话，支持自然语言指令、文件上下文选择（@filename）、多模型切换（/models）、会话管理（agent ls/resume）及内置快捷操作（Ctrl+R 审查变更、Shift+Enter 多行输入）。
非交互式/CI 模式：使用 agent -p 执行单条指令，支持 JSON/流式输出，适合自动化流水线。关键特性包括 --force 自动应用变更、--output-format json 结构化输出。
自动化关键方案：在 AI Agent 或脚本中调用时，必须通过 tmux 提供伪终端（PTY），否则 CLI 会因缺少 TTY 而无限挂起。文档提供了完整的 tmux 会话创建、指令发送、输出捕获流程。
显著优点
1. 官方原生支持：Cursor 官方维护，与 IDE 生态深度集成
2. 模型灵活性：支持 GPT-5 等多种模型，会话中实时切换
3. 上下文感知：通过 @ 语法精准选择文件/目录，结合 .cursor/rules、AGENTS.md 自动加载项目规范
4. MCP 生态：原生支持 Model Context Protocol 服务器热插拔（/mcp enable/disable）
5. CI/CD 就绪：结构化输出与强制模式支持自动化工作流
6. 会话持久化：可列出、恢复历史会话，适合长周期任务
潜在缺点与局限性
1. TTY 依赖陷阱：非交互场景必须配置 tmux，增加自动化复杂度
2. 首次运行交互：新 workspace 需处理信任提示（a 键确认），自动化脚本需额外等待和输入模拟
3. 平台限制：macOS 10.15+，Windows 仅支持 WSL
4. API 密钥管理：CI 场景需自行处理 CURSOR_API_KEY 环境变量安全
5. 输出捕获不确定性：tmux capture-pane 需预估等待时间，复杂任务可能超时或需轮询检测完成状态
适合人群
- 追求「终端优先」工作流的资深开发者
- 需要批量代码审查、重构的 Tech Lead
- 构建 AI 驱动 CI/CD 流水线的 DevOps 工程师
- 开发 AI Agent 需要调用专业编程工具的自动化系统构建者
常规风险
| 风险类别 | 说明 | 缓释建议 |
|---------|------|---------|
| 自动执行风险 | `--force` 可能应用未经人工审查的变更 | 生产环境禁用 `--force`，或结合 `--output-format json` 先审查再应用 |
| 密钥泄露 | `CURSOR_API_KEY` 暴露于环境变量或日志 | 使用 secrets 管理服务，避免硬编码 |
| 会话注入 | tmux 自动化中通过 `send-keys` 输入可能受特殊字符影响 | 对输入内容进行转义或使用 base64 编码传递 |
| 成本失控 | 长会话、多文件上下文可能消耗大量 Token | 定期使用 `/compress` 总结会话，控制上下文范围 |
| 权限越界 | MCP 服务器可能获得过度系统权限 | 遵循最小权限原则，按需启用/禁用服务器 |