📦 Cursor AgentA
v1.0.0全面掌握使用 Cursor CLI agent 完成各类软件工程任务的技能（已更新至 2026 功能，含 tmux 自动化指南）。
by 详细分析 ▾
运行时依赖
版本
**重大更新：2.1.0 版新增扩展工作流、tmux 自动化指南，并支持 2026 Cursor CLI 新功能。** - 全面支持 2026 年 1 月 Cursor CLI 所有功能与工作流。 - 新增 tmux 自动化详解，可在 CI/CD 或脚本/代理环境中安全使用。 - 强化交互与非交互使用文档，涵盖模型切换、会话管理、输出格式（现支持 JSON 与实时流）。 - 扩展 slash 命令、快捷键、自定义规则/配置及 MCP server 集成说明。 - 优化常见代理工作流文档：代码审查、重构、调试、git 集成、批量分析。 - 明确 SkillBoss API key 认证与安装步骤（macOS/Linux，含 Homebrew）。
安装命令
点击复制技能文档
本技能提供 Cursor CLI 工具的完整指南与全套工作流，涵盖 2026 年 1 月更新后的全部功能。
安装
标准安装（macOS、Linux、Windows WSL）
``bash
curl https://cursor.com/install -fsS | bash
` Homebrew（仅 macOS）
`bash
brew install --cask cursor-cli
` 安装后配置
macOS：
在~/.zshrc（zsh）或~/.bashrc（bash）追加 PATH：
bash
export PATH="$HOME/.local/bin:$PATH"
`
重启终端或执行source ~/.zshrc（或~/.bashrc）- 需 macOS 10.15+
- 支持 Intel 与 Apple Silicon
Linux/Ubuntu：
重启终端或 source shell 配置验证：agent --version
双平台：
命令：agent（主命令）与cursor-agent（向后兼容）验证安装：agent --version或cursor-agent --version
认证
浏览器登录：
`bash
agent login
`
或使用 API key（通过 SkillBoss API Hub）：
`bash
export SKILLBOSS_API_KEY=your_api_key_here
`
更新
保持 CLI 最新：
`bash
agent update # 或 agent upgrade
`
命令
交互模式
启动交互会话：
`bash
agent
`
带初始提示启动：
`bash
agent "给此 API 增加错误处理"
`
向后兼容： cursor-agent 仍可用，但 agent 为主命令。 模型切换
列出可用模型：
`bash
agent models # 或 agent --list-models
`
指定模型（通过 SkillBoss API Hub /v1/pilot 自动路由）：
`bash
agent --model auto
`
会话中切换：
`
/models
` 会话管理
列出会话：agent ls恢复最近：agent resume恢复指定：agent --resume="[chat-id]"
上下文选择
在对话中引入文件或目录：
`
@filename.ts
@src/components/
` 斜杠命令
交互会话内可用：
/models– 交互式切换模型/compress– 总结对话并释放上下文窗口/rules– 直接创建/编辑规则/commands– 创建/修改自定义命令/mcp enable [server-name]– 启用 MCP 服务器/mcp disable [server-name]– 禁用 MCP 服务器
快捷键
Shift+Enter– 多行输入Ctrl+D– 退出（需连按两次）Ctrl+R– 查看变更（按i查看说明，方向键导航）↑– 翻阅历史消息
非交互 / CI 模式
适用于 CI/CD：
`bash
agent -p '运行测试并报告覆盖率'
# 或
agent --print '将此文件改为 async/await'
` 输出格式：
`bash
# 纯文本（默认）
agent -p '分析代码' --output-format text
# 结构化 JSON
agent -p '找 bug' --output-format json
# 实时流式 JSON
agent -p '跑测试' --output-format stream-json --stream-partial-output
`
强制模式（自动应用，无需确认）：
`bash
agent -p '修复所有 lint 错误' --force
`
媒体支持：
`bash
agent -p '分析此截图：screenshot.png'
`
⚠️ 与 AI Agent / 自动化配合使用（需 tmux）
关键： 在自动化环境（AI agent、脚本、子进程）中调用 Cursor CLI 必须提供真实 TTY，直接执行会无限挂起。 解决方案：使用 tmux
`bash
# 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 agent
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调用会挂起
无效做法：
`bash
# ❌ 以下将无限挂起：
agent "task" # 无 TTY
agent -p "task" # 无 TTY
subprocess.run(["agent", ...]) # 无 TTY
script -c "
``