tuios

项目简介

tuios 是一个终端窗口管理器与多路复用器，运行在现有终端中。它提供平铺窗格、浮动窗口、工作区、用于保持会话的守护进程、对其他机器上会话的访问，以及面向编码代理的状态与集中收件箱功能。

核心功能

• 提供平铺窗格和浮动窗口，支持 BSP、主栈和滚动布局，并配有停靠栏和侧边栏。
• 提供九个独立工作区，以及受 vim 启发的模态界面，包含窗口模式和终端模式。
• 守护进程在分离或关闭终端后继续运行窗格和程序，之后可在本地或通过 SSH 重新附加会话。
• 可通过主机和远程会话功能添加另一台机器，并附加到其会话或在该机器上运行单个窗格。
• 窗格中的编码代理可报告正在工作、等待、完成或出错等状态，集中收件箱汇总审批、问题、邮件、错误和已完成的回合。
• 支持通过 JSON 控制协议、send-keys、capture-pane、wait-for、tape 脚本、钩子和命令行进行脚本化与自动化。

适用场景

• 在同一个终端中并排运行多个编码代理，并集中查看它们的状态和待处理审批。
• 关闭终端后让长时间运行的构建、测试或代理会话继续存活，之后再重新附加。
• 通过附加远程会话或把单个窗格放到另一台主机上，跨多台机器工作。
• 使用 tape 脚本、钩子和 JSON 控制协议自动化或回放终端工作流。

快速开始

• 使用 Homebrew 安装：brew install tuios。
• 运行 tuios；若守护进程未运行，它会启动守护进程并将会话附加给你。
• 使用 n 新建窗口，i 或 Enter 进入终端模式，Ctrl+B 后按 Esc 返回窗口模式，Ctrl+P 打开命令面板。
• 也可以选择在安装前通过浏览器体验引导教程。

部署与要求

• 需要支持真彩色的终端；推荐支持 Kitty 图形和 Sixel，例如 Ghostty、Kitty 或 WezTerm。
• 从源码构建需要 Go 1.26.8 或更新版本。
• 提供适用于 Linux、macOS、Windows、FreeBSD 和 OpenBSD 的预构建二进制文件；也发布 Docker 镜像。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。