来自可验证开发者的 Cursor CLI 官方工具完整使用指南，涵盖安装、认证、交互/非交互模式及 CI/CD 自动化，助力开发者高效完成代码审查、重构与调试任务。
说明：
## 核心用法
`cursor-agent` Skill 是一份面向 Cursor CLI 工具的综合性使用文档，旨在帮助开发者掌握这一 AI 驱动的终端编程助手。该 Skill 覆盖了从基础安装到高级自动化工作流的完整使用链路。
**安装与认证**：支持 macOS、Linux 及 Windows WSL 多平台，提供标准 curl 安装和 Homebrew 两种途径，安装后需通过 `agent login` 浏览器认证或 API Key 环境变量配置完成授权。
**交互模式**：通过 `agent` 命令启动对话式会话，支持 `@` 符号快速引用文件/目录作为上下文，内置 `/models` 切换模型、、`/compress` 压缩对话历史、、`/rules` 管理规则等斜杠命令，以及 `Shift+Enter` 多行输入、、`Ctrl+R` 审查变更等快捷键。
**非交互/CI 模式**：专为自动化场景设计，使用 `-p` 或 `–print` 参数执行单次任务，支持 `text`/`/`json`/`/`stream-json` 三种输出格式，，`–force` 参数可自动应用变更无需确认，适合集成到 CI/CD 流水线执行代码审计、测试覆盖报告生成等任务。
**关键自动化方案**：针对 AI Agent 调用场景，文档特别强调必须使用 tmux 创建伪终端（PTY），因为 Cursor CLI 的 TUI 依赖真实 TTY，直接子进程调用会导致无限挂起。提供了完整的 tmux 会话创建、命令发送、输出捕获的脚本模板。
## 显著优点
1. **功能覆盖全面**：从个人开发到企业 CI/CD 的全场景支持，既满足日常编码辅助，也支持批量自动化处理。
2. **上下文感知能力强**：通过 `@` 符号精准注入文件/目录上下文，结合自动加载的 `.cursor/rules`、`、`AGENTS.md` 等配置，实现项目级知识融合。
3. **MCP 生态集成**：原生支持 Model Context Protocol 服务器动态启停，可扩展工具链能力。
4. **输出格式灵活**：JSON 和流式 JSON 输出便于程序化处理，适配现代 DevOps 工具链。
5. **会话持久化**：支持会话列表查看与指定会话恢复，长任务可中断续作。
## 潜在缺点与局限性
1. **TTY 强依赖限制**：自动化场景必须借助 tmux 等工具模拟终端，增加了部署复杂度，容器化环境需额外配置。
2. **平台覆盖缺口**：Windows 原生环境仅支持 WSL，无原生 Windows 终端支持。
3. **成本不透明**：依赖 Cursor 官方 API，高频 CI 使用可能产生显著费用，文档未提供成本估算指引。
4. **变更不可控风险**：`–force` 模式自动应用代码变更，缺乏人工审查环节，可能引入回归问题。
5. **网络依赖严格**：安装脚本、模型切换、API 调用均需稳定网络，离线环境无法使用。
## 适合的目标群体
– **全栈开发者**：需要快速完成代码审查、重构、调试等日常任务
– **DevOps/平台工程师**：构建智能化 CI/CD 流水线，实现自动化代码审计与测试
– **技术团队 Lead**：制定团队编码规范，通过 `.cursor/rules` 统一代码风格
– **AI 工作流构建者**：开发基于 Cursor 能力的自动化 Agent 系统
## 使用风险
– **性能风险**：大文件分析或复杂重构任务可能消耗大量 Token 与 API 配额
– **依赖项风险**：tmux 为自动化场景必需依赖，环境缺失将导致任务挂死
– **安全风险**：`–force` 模式可能未经充分测试即提交变更，建议配合代码审查流程使用
– **供应商锁定**：深度集成 Cursor 生态后，迁移至其他 AI 编程工具成本较高
会员专属
