启动
vibex status 在出问题时应该第一个运行：它会说明这个 home 会用哪种运行时、连哪个端点，以及为什么。
本机模式与远程模式
如果 home 被锁住、桌面端又没允许 TUI 接入，客户端会打印它尝试过的端点和三种出路：在桌面端打开 设置 → 常规 → Vibex TUI、退出桌面端，或连接到另一个运行时。
界面
界面是一列全宽横带：状态、对话流、回合状态、输入框和快捷键栏。窗口变窄时，装饰、队列和状态带会先让位，对话流和输入框保留；没有最小尺寸，也不会弹“窗口太小”。- 结束的回合折在
▸ Worked for 12s分隔线后面，点它或按e展开。 - 滚走的用户消息会钉在视口上方，不会随着滚动消失。
/在对话流里搜索，支持智能大小写正则；n/p跳转匹配。- 拖选文本会通过 OSC 52 复制，SSH 和 tmux 里也能用。
- 长粘贴收成
[Pasted: 42 lines]芯片，图片从剪贴板、粘贴或拖入文件变成芯片。 - 状态带显示工作区、连接状态和当前模式；回合状态行显示正在运行的工具、耗时和审批数。
输入框
运行中写下的消息会进入队列，回合结束后自动发出。队列属于它写入的会话：切走再回来，它还在原处。
会话
vibex 打开时默认落在当前目录的新会话页，目录和上次使用的运行时已经填好。直接输入第一条消息即可创建会话；标题来自这条消息。
n新建会话，Ctrl+W改工作区，Ctrl+G打开 Agent 设置。Ctrl+L或1打开会话列表；Esc在输入页和列表之间切换。- 会话列表按桌面端的排布绘制，支持置顶、重命名、分叉、归档、分组和拖动排序。
- 委派的子会话以树形分支显示，行尾的开关展开分支。
e打开选中行的详情，c关闭所有详情卡，y复制会话信息。
审批、提问与队列
Agent 的请求就地出现：- 审批是页面上的卡片：
a允许，d拒绝，Ctrl+A本会话始终允许。 - 提问占据输入框横带，用
Tab在字段间移动，Enter提交。 - 自动继续保留桌面端的五秒倒计时；
t停止本次自动继续。 - 队列用
Alt+↑↓选行，Alt+E拉回草稿，Alt+X删除，Alt+J/K调整顺序，Alt+Enter打断当前回合并立即发送。 Alt+D打开 Dock，集中显示正在运行的子 Agent、计划和被持有的消息。
管理、配对与设置
管理页是桌面风格的配置中心，包含 Agent、Providers、Model、MCP、Skill、Prompt 和 配对与远程访问。只显示当前运行时真的能提供的操作；没有权限的操作会说明原因，而不是消失。 配对页把 配对、已配对设备 和 远程访问 放在同一个标签条里：- 二维码、一次性配对码和链接都在面板里生成。
- 一次配对会携带运行时发布的所有路由，用
[/]切换。 - 本机局域网配对窗口用
a允许、r拒绝。 - 已配对设备可以撤销，并查看远程协议审计。
en / zh-CN / zh-TW）、图标集、着陆 logo、动效、推理显示、默认工作区和键位绑定。所有选择写入 ~/.vibex/tui-interface.json，键位写入 ~/.vibex/tui-keys.toml。
快捷键速查
键位可以在设置里逐项修改；冲突的键位会被拒绝，并指出已经占用它的动作。TUI 也会读取
~/.vibex/tui-keys.toml。
通知与终端行为
通知通过终端转义序列送达。附着到桌面端时，通知通道会让给桌面端，同一个事件只从一个通道来。 TUI 会接管终端的键盘协议：支持扩展键的终端能区分Enter 和 Shift+Enter；不支持的终端退回 Ctrl+J 换行。复制使用 OSC 52，所以在 SSH 和 tmux 里也能工作。
限制
TUI 专注于会话和运行时的可操作性，不是桌面工作台的完整替代：- 不提供文件编辑器、Markdown/PDF/Office 预览、内嵌浏览器或电脑操作面板。
- 图片附件以终端能显示的方式呈现，复杂图片仍建议在桌面端查看。
- 远程模式下没有原生引导，
Ctrl+S会退化为打断并重发。 - 电脑操作和浏览器面板的实时画面不在 TUI 中提供。