Agent CLI — 代码编辑工具路由#

工具选择#

工具命令适用场景详细文档Cursor CLIagent代码重构、Review、Debug、Git 提交信息、自动化 CIreferences/cursorcli.mdQoder CLIqodercli交互式代码开发、MCP 集成、多任务并行（worktree）、子 Agent 调度references/qodercli.md

何时使用#

• 写代码 / 改代码 / 重构 → 必须用 Cursor CLI 或 Qoder CLI（禁止直接 exec 改代码）
• 启动前告知用户：「我打算用 Cursor/Qoder 来处理」
• 保持透明，让用户知道任务去向

选择逻辑#

1. 已有 Cursor 登录 / 项目有 .cursor/ 配置 → 优先 Cursor
2. 需要 MCP 集成 / worktree 并行 / 子 Agent → 用 Qoder
3. 简单代码修改 → 两者均可，默认 Cursor
4. 用户明确指定 → 按用户要求

调用方式#

两个 CLI 都是 TUI 程序，在自动化场景下必须通过 tmux 提供 PTY：

bash

tmux kill-session -t agent 2>/dev/null || true
tmux new-session -d -s agent
tmux send-keys -t agent "cd /path/to/project" Enter
sleep 1
tmux send-keys -t agent "agent '你的任务'" Enter   # 或 qodercli

⚠️ 直接 agent "task" 或 qodercli "task" 会卡死（无 TTY）

参考文档#

• 详细操作手册 → references/cursorcli.md（Cursor）、 references/qodercli.md（Qoder）
• 安装 / PATH / 登录入口 → references/README.md