如何快速上手 boo:5 分钟完成安装并创建你的第一个持久化终端会话
如何快速上手 boo:5 分钟完成安装并创建你的第一个持久化终端会话
boo 是一款 GNU screen 风格的终端复用器(terminal multiplexer),基于 libghostty 构建、用 Zig 编写。它的核心能力是"会话持久化":你断开 SSH 或关闭终端窗口后,会话仍在后台继续运行;重新 attach 时,屏幕内容、滚动历史、光标和窗口标题都会原样恢复。如果你正在寻找比 GNU screen 更现代、比 tmux 更轻量的终端会话管理工具,本文带你在 5 分钟内装好 boo 并跑通第一个会话。🚀
一、什么是 boo?它和 GNU screen、tmux 有什么区别?
boo 的设计哲学与 GNU screen 一致:会话(session)+ 前缀键(Ctrl-A),无需学习复杂配置。但 boo 用 Ghostty 终端模拟器的核心(libghostty-vt)替换了 screen 那套陈旧多年的终端解析层,因此:
- 重绘更忠实:SGR 颜色样式、光标位置、滚动区域、窗口标题、终端模式都能精确还原;
- 后台也能应答终端查询:detach 状态下 TUI 程序不会卡死;
- 对脚本和 AI Agent 友好:
send/peek/wait等原语可无终端(headless)驱动交互式程序。
架构上,boo 采用"客户端 + 守护进程"模型:你的终端通过 Unix socket 连接会话守护进程,后者持有 PTY 并维护终端状态。相关实现可参考 src/client.zig、src/daemon.zig、src/window.zig 与 src/protocol.zig。
二、boo 安装方法:3 种方式拿到 boo 命令
boo 支持 Linux 与 macOS(x86_64 / aarch64)。以下是三种安装方式,任选其一。🛠️
方式 1:运行官方安装脚本(推荐,最快)
克隆仓库后执行 install.sh,它会自动下载对应平台的预编译二进制并安装:
git clone https://gitcode.com/gh_mirrors/boo10/boo
cd boo
sh install.sh
- 默认安装到
/usr/local/bin(不可写时回退到~/.local/bin); - 可用环境变量
BOO_VERSION锁定版本,BOO_INSTALL_DIR指定安装目录,详见 install.sh 头部注释; - 若目录不在
PATH中,脚本会打印添加到PATH的具体命令,照做即可。
方式 2:从源码构建
需要 Zig 0.15.2,依赖会自动拉取并编译:
git clone https://gitcode.com/gh_mirrors/boo10/boo
cd boo
zig build # 产物位于 zig-out/bin/boo
方式 3:使用 Nix
仓库自带 flake.nix:nix develop 可进入含正确 Zig 版本的开发环境,nix build 会构建出 ./result/bin/boo。
安装完成后验证:
boo version
三、创建你的第一个持久化终端会话:4 条命令跑通全流程
1️⃣ 新建会话并立即进入
boo new work
不指定命令时,会话运行你的 $SHELL。不加名字时,会话会自动以当前目录名命名。给会话取个好名字,后面操作会方便很多。
2️⃣ 按前缀键 detach,会话转入后台
在会话内按 Ctrl-A,松开后再按 d(即 C-a d),即可分离(detach)。此时你的终端回到普通 shell,但 work 会话里的程序(比如一个正在编译的 make)仍在后台运行。这就是"持久化"的关键一步。💪
3️⃣ 随时重新 attach,屏幕原样恢复
boo attach work # 别名:boo at work 或 boo a work
重新连接时,屏幕、滚动回看、光标位置和窗口标题都会从终端状态精确重建——就像你从未离开过。会话名支持唯一前缀匹配,例如 boo at w 即可命中 work。
4️⃣ 列出与结束会话
boo ls # 列出所有会话(名称、attach 状态、空闲时长、标题)
boo kill work # 结束指定会话
boo kill --all # 结束全部会话
常用命令速查表(完整列表见 README.md 的 Usage 一节):
| 命令 | 作用 |
|---|---|
boo new [name] |
新建会话并 attach |
boo new name -d -- cmd |
后台创建并直接运行命令 |
boo attach name |
重新连接会话 |
boo rename old new |
重命名会话 |
boo ui |
全屏会话管理器 |
boo help <command> |
查看任意命令的详细帮助 |
所有命令的帮助文本集中定义在 src/help.zig,boo help --all 可一次性打印全部帮助页。
四、boo 快捷键速查表:只需记住 C-a 前缀
会话内的键位与 GNU screen 默认一致,前缀键为 Ctrl-A(源码中的按键映射见 src/keys.zig):
| 按键 | 作用 |
|---|---|
C-a d(或 C-a C-d) |
分离会话(detach) |
C-a l(或 C-a C-l) |
重绘屏幕 |
C-a a |
发送一个字面的 C-a |
五、boo ui:全屏多会话管理器
多个会话时,用 boo ui(别名 i)一键接管:左侧边栏列出全部会话及窗口标题,右侧实时渲染当前聚焦会话。支持:
- 鼠标操作:点击会话聚焦、点击
x结束、滚轮翻历史; - 键位扩展:
C-a c新建、C-a k结束、C-a r重命名、C-a n/C-a p切换上/下一个会话、C-a s隐藏侧栏; - 状态标记:
●表示你不在时响过铃,•表示有未读输出,*表示被其他客户端 attach。
完整键位说明见 src/help.zig。
六、进阶:用脚本驱动你的终端会话
除了 attach,boo 的所有命令都可以在没有终端的情况下运行,这让 boo 成为脚本和 AI Agent 的天然沙箱。官方推荐的标准循环(见 README.md Automation 一节):
boo new build -d -- bash # 1. 创建无头会话
boo send build --text 'make' --enter # 2. 向会话输入
boo wait build --idle # 3. 等待输出稳定
boo peek build --scrollback # 4. 读取渲染后的屏幕
boo kill build # 5. 清理
send按字面发送文本,无转义、无隐式换行,引号地狱不再存在;wait --text/--idle取代"sleep + 轮询",还能用--timeout 2m防止死等;peek --json输出机器可读的屏幕状态(尺寸、光标、标题、内容);- 退出码语义化:
3表示会话不存在,4表示等待超时,方便脚本分支。
端到端行为可参考集成测试 test/integration.zig。
七、常见问题与注意事项
- 一个会话同时只能有一个 attach 客户端:新的 attach 会"礼貌地抢走"(steal)旧客户端,不支持多人共享;
- 一个会话一个窗口:没有窗口分割或页签,建议"一个任务一个会话",用
boo ui调度; - 前缀键
C-a暂不可配置,粘贴内容中的0x01字节会被解释为前缀(GNU screen 同样如此,boo ui因括号粘贴机制不受影响); - 会话统一以
TERM=xterm-256color运行; - 调试时可设置
BOO_LOG环境变量记录守护进程日志。
以上限制详见 README.md 的 Caveats 一节。boo 目前是个年轻项目,定位是"现代版 GNU screen",而非 GNU screen 的直接替代。
总结:3 句话回顾
- 安装:
git clone后执行sh install.sh,或使用zig build从源码构建; - 持久化:
boo new work建会话 →C-a d分离 →boo attach work随时找回,屏幕原样恢复; - 管理:
boo ls查看、boo ui全屏调度、boo kill清理,脚本场景再用send/wait/peek三件套。
从 boo new 到 detach / attach,整个流程不超过 5 分钟。会话" haunting "你的终端——这正是 boo 的口号。✨