TUI 终端界面

TUI 是 Cocode 的终端客户端，适合键盘流、SSH、远程服务器和不需要图形桌面的工作环境。它需要真实 TTY；在 CI 或管道中运行前请确认终端能力。

启动 TUI

先安装 Node.js 22.19.x 或更高版本，再安装 TUI：

npm install --global @cocode-agency/tui
cocode doctor

在项目目录中运行：

cd your-project
cocode tui

终端中的基本路径

输入任务目标。
查看 Cocode 的计划和当前状态。
使用键盘在任务、输出和确认区域之间移动。
确认或拒绝文件、命令和联网动作。
查看 diff、测试输出和最终结论。

常用命令包括 /login、/logout、/use byok、/use cocode、/status、/resume、/rewind、/review、/export、/focus 和 /help。/review 是只读 Git Review，不会修改、暂存或提交文件。

Shift+Tab 切换权限模式，Ctrl+M 切换输入/多行模式，Ctrl+O 控制输出折叠。审批面板中：Enter 或 a 允许一次，t 允许本轮，d 或 n 拒绝。具体键位以当前版本的 CLI 与快捷键参考和运行时 capability 为准。

适合 TUI 的场景

通过 SSH 连接开发机或服务器。
希望尽量不离开终端。
使用键盘推进连续任务。
在没有完整桌面环境的机器上工作。

与 GUI 的区别

任务、会话、模型和权限规则保持一致；不同的是呈现和操作方式。GUI 以面板和鼠标交互为主，TUI 以终端布局、键盘和输出流为主。只有相同 DSH_HOME、profile 和 Host scope 才能共享本地会话。

登录与模型通道

TUI 可以使用设备码登录 Cocode，也可以通过 /use byok 配置自己的 API Key 或 endpoint。/status 用于确认当前通道、模型和运行时状态；凭据不会写入公开文档或 session log。

终端中的基本路径

输入任务目标。

查看 Cocode 的计划和当前状态。

使用键盘在任务、输出和确认区域之间移动。

确认或拒绝文件、命令和联网动作。

查看 diff、测试输出和最终结论。