Cursor CLI Agent — Cursor 命令行界面代理

Cursor CLI 代理技能 该技能提供了一个全面指南和工作流程，用于利用 Cursor CLI 工具，包括 2026 年 1 月更新的所有功能。

安装 标准安装（macOS、Linux、Windows WSL） curl https://cursor.com/install -fsS | bash Homebrew（仅限 macOS） brew install --cask cursor-cli

安装后设置 macOS：在 ~/.zshrc（zsh）或 ~/.bashrc（bash）中添加到 PATH： export PATH="$HOME/.local/bin:$PATH" 重启终端或运行 source ~/.zshrc（或 ~/.bashrc） 需要 macOS 10.15 或更高版本 兼容 Intel 和 Apple Silicon Mac Linux/Ubuntu：重启终端或源 shell 配置 验证：agent --version 两个平台： 命令：agent（主命令）和 cursor-agent（向后兼容） 验证安装：agent --version 或 cursor-agent --version

身份验证 通过浏览器身份验证：agent login 或使用 API 密钥：export CURSOR_API_KEY=your_api_key_here

更新 保持 CLI 更新：agent update # 或 agent upgrade

命令 交互模式 启动交互式会话：agent 启动带有初始提示：agent "添加错误处理到此 API" 向后兼容：cursor-agent 仍然有效，但 agent 现在是主命令。

模型切换 列出所有可用模型：agent models # 或 agent --list-models 使用特定模型：agent --model gpt-5 会话期间切换模型：/models

会话管理 管理代理会话： 列出会话：agent ls 恢复最近会话：agent resume 恢复特定会话：agent --resume="[chat-id]"

上下文选择 在对话中包含特定文件或文件夹：@filename.ts @src/components/

斜线命令 在交互式会话期间可用： /models - 交互式切换 AI 模型 /compress - 总结对话并释放上下文窗口 /rules - 直接从 CLI 创建和编辑规则 /commands - 创建和修改自定义命令 /mcp enable [server-name] - 启用 MCP 服务器 /mcp disable [server-name] - 禁用 MCP 服务器

键盘快捷键 Shift+Enter - 为多行提示添加新行 Ctrl+D - 退出 CLI（需要双击以确保安全） Ctrl+R - 审查更改（按 i 获取说明，使用箭头键导航） 向上箭头 - 循环浏览之前的消息

非交互式/CI 模式 以非交互式模式运行代理，适合 CI/CD 管道： agent -p '运行测试并报告覆盖率' # 或 agent --print '重构此文件以使用 async/await' 输出格式： # 纯文本（默认） agent -p '分析代码' --output-format text # 结构化 JSON agent -p '查找错误' --output-format json # 实时流式 JSON agent -p '运行测试' --output-format stream-json --stream-partial-output 强制模式（自动应用更改而不需要确认）： agent -p '修复所有 linting 错误' --force 媒体支持： agent -p '分析此截图：screenshot.png'

使用 AI 代理/自动化（需要 tmux） CRITICAL：当从自动化环境（AI 代理、脚本、子进程调用）运行 Cursor CLI 时，CLI 需要一个真实的 TTY。直接执行将无限挂起。 解决方案：使用 tmux # 1. 如果没有 tmux，则安装它 sudo apt install tmux # Ubuntu/Debian brew install tmux # macOS # 2. 创建一个 tmux 会话 tmux kill-session -t cursor 2>/dev/null || true tmux new-session -d -s cursor # 3. 导航到项目 tmux send-keys -t cursor "cd /path/to/project" Enter sleep 1 # 4. 运行 Cursor 代理 tmux send-keys -t cursor "agent '您的任务在此'" Enter # 5. 处理工作空间信任提示（第一次运行） sleep 3 tmux send-keys -t cursor "a" # 信任工作空间 # 6. 等待完成 sleep 60 # 根据任务复杂性调整 # 7. 捕获输出 tmux capture-pane -t cursor -p -S -100 # 8. 验证结果 ls -la /path/to/project/

为什么有效： tmux 提供了一个持久的伪终端（PTY） Cursor 的 TUI 需要交互式终端功能 直接从子进程/执行调用代理将无限挂起而不需要 TTY

什么不起作用： # ❌ 这些将无限挂起： agent "任务" # 没有 TTY agent -p "任务" # 没有 TTY subprocess.run(["agent", ...]) # 没有 TTY script -c "agent ..." /dev/null # 可能会崩溃 Cursor

规则和配置 代理自动从以下位置加载规则： .cursor/rules AGENTS.md CLAUDE.md 使用 /rules 命令直接从 CLI 创建和编辑规则。

MCP 集成 MCP 服务器自动从 mcp.json 配置中加载。 启用/禁用服务器： /mcp enable server-name /mcp disable server-name 注意：带有空格的服务器名称得到完全支持。

工作流程 代码审查 对当前更改或特定分支执行代码审查： agent -p '审查当前分支的更改与主分支。关注安全性和性能。'

重构 重构代码以提高可读性或性能： agent -p '重构 src/utils.ts 以降低复杂性并提高类型安全性。'

调试 分析日志或错误消息...