TUI

Mosaic Terminal UI（tui）

mosaic tui 是 chat-first 全屏终端界面，包含会话列表、消息流和实时工具 inspector。

行为约定：交互模式进入全屏 TUI；非交互模式通过 --prompt 走单次调用。

1. 启动 TUI

mosaic --project-state tui

2. 启动参数

# 初始焦点: messages|input|sessions|inspector
mosaic --project-state tui --focus sessions

# 启动时隐藏右侧 inspector
mosaic --project-state tui --no-inspector

# 恢复指定会话
mosaic --project-state tui --session <session_id>

# 按常规指定 profile/agent
mosaic --project-state --profile default tui --agent writer

3. 非交互单次调用

# 脚本模式，不进入全屏 UI
mosaic --project-state tui --prompt "hello"

# 兼容 JSON 契约
mosaic --project-state --json tui --prompt "hello"

当 stdin/stdout 不是 TTY 且未提供 --prompt 时，会返回 validation error。

4. 快捷键

Enter：发送
Ctrl+J：换行
Tab：切换焦点（messages/input/sessions/inspector）
Ctrl+N：新建会话
Ctrl+R：刷新会话列表
Ctrl+I：切换 inspector
?：帮助面板
q 或 Ctrl+C：退出

5. 布局自适应

宽终端：左 sessions + 中 messages + 右 inspector。
中等宽度：自动隐藏 inspector。
极窄终端：左栏折叠为顶部状态条。

6. 排障建议

# 检查状态目录和写权限
mosaic --project-state directory --ensure --check-writable

# 启动 TUI 前先确认配置/连通性
mosaic --project-state status
mosaic --project-state health

10 分钟上手 Sessions 教程 Agents 专项策略教程生产运维排障手册返回路径导航