核心用法
cursor-tui 是一个 Cursor Agent CLI 的透明代理桥接工具。它通过 exec 在后台 PTY 中启动 agent 二进制文件（或兼容别名 cursor-agent），并将用户的输入与 Cursor 的输出进行双向中继。用户可通过单条命令启动会话，随后以交互方式向 Cursor Agent 提问、追加代码上下文（@filename 或 @directory/），或批准/拒绝 Agent 提出的终端命令执行请求。工具支持特殊按键（方向键、Escape 等）的转发，以及通过 /quit 或 Ctrl+D 优雅结束会话。
显著优点
1. 零摩擦集成：无需离开当前对话环境即可使用 Cursor 的 Agent 能力，保持工作流连续性。
2. 透明中继：严格遵循 passthrough 模式，不添加额外解释或格式化，确保用户获得原汁原味的 Cursor 输出。
3. 完整交互支持：不仅支持文本输入，还能处理多行粘贴、特殊按键，以及对 Cursor 权限提示（如"Run this command?"）进行人工确认中转，避免越权自动批准。
4. 灵活上下文追加：支持在交互过程中通过 @ 语法动态附加文件或目录上下文。
潜在缺点与局限性
- 单会话限制：同一时间通常只能运行一个会话，需手动检查孤儿会话 (
process list)。 - 首次信任门槛：新目录首次运行需处理 workspace trust 提示，增加一步交互。
- PATH 依赖：要求
agent/cursor-agent二进制文件在系统 PATH 中，否则需查阅TOOLS.md配置自定义路径。 - PTY 开销：后台 PTY 会话带来额外的进程管理复杂度，异常退出时可能需要手动清理。
适合人群
- 希望在统一对话界面中调用 Cursor Agent 能力的开发者；
- 需要频繁与 Agent 交互、但不想切换窗口或启动完整 Cursor IDE 的用户；
- 重视人工确认安全边界、不愿让 AI 自动执行终端命令的谨慎型用户。
常规风险
- 命令执行风险：尽管工具本身不自动批准 Cursor 的权限请求，但用户若误批准，可能导致非预期命令执行。需保持对 Agent 提议命令的警觉。
- 会话管理风险：后台进程可能因网络中断或异常崩溃成为孤儿进程，长期占用资源。
- 上下文泄露：通过
@附加文件时，需确认不包含敏感凭证或隐私数据。 - 工作目录混淆：必须显式指定
workdir且非 OpenClaw workspace，误设可能导致 Agent 在错误路径操作。