TUI 终端模式

中文 | English

BIT 除图形界面外内置终端模式（TUI），适合 SSH / 无显示器环境。

启动

bit        # 交互式终端里直接输入即可进入 TUI
bit tui    # 同效（显式写法）

判定规则：stdin 是交互终端（TTY）时裸 bit 进入 TUI；Finder 双击 / .desktop 图标 / open -a / 自动更新重启等无 TTY 的启动方式仍打开桌面端，互不干扰。

（安装 CLI 后 bit 命令可用；未安装时用应用内二进制路径直接运行）

命令

命令	说明
/help	显示帮助
/sessions	列出会话
/new [标题]	新建会话并切换
/use <id>	切换会话（id 可只写前几位）
/tools	列出工具
/mem <内容>	沉淀一条记忆
/mems	查看记忆
/install-cli	把 bit 命令安装到终端 PATH
/quit	退出

其他任意输入即为对话消息；工具调用过程逐行展示。

与桌面端并行

TUI 与桌面端共用同一数据目录，可同时运行互不冲突（会话、工具、记忆实时共享）。TUI 退出不影响桌面端。

管道行为

• stdin 关闭（EOF）即干净退出，适合脚本场景
• 非法命令、损坏的 ai_config.json、AI 不可达均不崩溃，报错后 REPL 继续可用

远程机器上的用法

TUI 只依赖本机二进制，无需图形环境。在无桌面的服务器上：

# 全新数据目录直接以 TUI 方式使用
BIT_DATA_DIR=~/.bit-server bit tui

配置 AI 提供方与桌面端相同（ai_config.json），或直接复用从桌面机器同步来的数据目录。