thurbox README

项目的 README,来自 github.com/Thurbeen/thurbox。合并为一个 markdown 文件:README.md。

Thurbox

thurbox

CI License: MIT Website Discord Quality Gate Status

Thurbox Demo

Installation

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/Thurbeen/thurbox/main/scripts/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/Thurbeen/thurbox/main/scripts/install.ps1 | iex

That installs both binaries — thurbox (the TUI) and thurbox-cli (the headless one) — with checksum verification and platform auto-detection.

You also need tmux ≥ 3.2 (or psmux ≥ 3.3.8 on native Windows), git, and at least one coding-agent CLI. RMUX ≥ 0.10.0 is an opt-in alternative, tested with thurbox on Linux. Install it separately, then select RMUX after tmux in the new-session picker (Ctrl+N); it appears locally when rmux is on PATH. See multiplexer requirements and setup for verified versions, config defaults, host support, and limits.

Nix / NixOS:

nix run github:Thurbeen/thurbox                # try it
nix profile install github:Thurbeen/thurbox    # install it

On NixOS, add github:Thurbeen/thurbox as a flake input and import thurbox.nixosModules.default with programs.thurbox.enable = true;. The Installation page has the full snippet, the overlay and the Home Manager module.

Homebrew, the AUR, winget, Chocolatey, building from source, pinning a version and changing the install directory are all on the Installation page.

Uninstall: removing the binaries is not enough — sessions keep running in the selected multiplexer. Follow the uninstall steps.

Your first session

thurbox

First launch seeds ~/.config/thurbox/ — the themes and the interface itself — and starts Fleet, which runs every session. It then draws a session list on the left and an agent terminal on the right.

  1. Ctrl+N opens the new-session flow. Pick a repository, name the session, then pick an agent from the harnesses Fleet offers. Fleet gives the session a worktree of its own.
  2. Talk to it. The right pane is a live agent CLI; every key goes to it.
  3. Ctrl+N again for a second agent, on the same repository or another. Ctrl+J / Ctrl+K move between sessions — the one you are not looking at keeps working.
  4. Ctrl+Q leaves the TUI without killing anything. Run thurbox again and both agents are still mid-task, or attach to one with fleet attach <task>.

That is the whole product in four steps: parallel work that keeps going when you stop watching it.

F1 lists every key and is rendered from the live registry, so it cannot drift from what is running; Ctrl+P is a command palette over the same actions. For the same walkthrough with screenshots, see the tutorial.

Session creation

What else it does

Starting a session per package of a monorepo from one script is the monorepo recipe.

Make it yours

The binary boots a kernel, reads a directory, and draws whatever Lua it finds there. Panes live in ui/plugins/*.lua, the arrangement in ui/layout.lua, and F10 reloads both from disk. Hosts, themes, chords and settings are each a file under ~/.config/thurbox/.

You do not have to learn Lua for any of it. The interface directory ships an AGENTS.md that teaches whichever CLI you run how the interface is put together, so from a session opened there you can just ask:

Add a pane on the left with CPU and RAM usage. Move the search strip to the bottom and make the session column 30% wide.

Press F10 and the change is on your screen. If a pane breaks, Ctrl+, then ] is chrome rather than a pane, so it cannot be edited away — r restores a shipped file, space turns yours off.

The Interface → · Writing a pane → · Configuration →

Turning a pane off from the Interface tab

Plugins → — official and community panes and other add-ons, with install commands and submission details.

Documentation

thurbox.thurbeen.eu/docs is the manual: installation, tutorial, features, keybindings, configuration, agents, the interface, orchestration, architecture, a comparison with similar tools and an FAQ.

The rationale behind the decisions is in this repository, under docs/: constitution (non-negotiable principles), ARCHITECTURE, FEATURES, CONFIG, KERNEL, PLUGINS, ORCHESTRATION, DEVELOPMENT and RELEASING.

Contributing

CONTRIBUTING.md is the full guide — the Nix dev shell, the just tasks, the test discipline, and the conventional-commit rules that decide what gets released.

git clone https://github.com/Thurbeen/thurbox.git
cd thurbox
nix develop          # or ./scripts/install-dev-tools.sh
just build && just test && just lint

Community

License

MIT — see LICENSE. Built on ratatui, tui-term, vt100 and tmux.

thurbox (Thurbeen/thurbox)

正在搜索数据库…

这是什么?Thurbox 是一个终端界面,可以并排运行多个编程智能体,包括 Claude Code、Codex、Antigravity、opencode、aider,或你自己描述的任何命令行工具。每个智能体都运行在自己的持久会话中,退出 TUI 后会话仍会继续运行。
它会取代 tmux,还是运行在 tmux 之上?它运行在终端复用器之上:thurbox 负责管理会话,但需要底层运行 tmux(或作为替代的 psmux/RMUX),以便在重启之间保持智能体持续运行。
怎么让它运行起来?在 Linux/macOS 上运行安装脚本,或在 Windows 上运行 PowerShell 命令,即可同时安装 thurbox TUI 和无界面的 thurbox-cli 二进制文件,并自动校验校验和。也提供 Nix/NixOS、Homebrew、AUR、winget 和 Chocolatey 的安装包。
运行之前需要先安装什么?tmux 3.2 或更高版本(在原生 Windows 上可用 psmux 3.3.7 或更高版本,或选择启用 RMUX 0.10.0 或更高版本作为替代),git,以及至少一个编程智能体命令行工具,例如 Claude Code 或 Codex。
卸载是不是只要删除二进制文件就行?不是。只删除二进制文件会留下仍在复用器中运行的会话,以及残留在编程智能体自身配置目录中的钩子和技能,因此需要按照专门的卸载步骤操作。
它在 Windows 上也能用吗,还是只支持 Linux/macOS?它支持 Linux、macOS、Windows(通过 PowerShell 安装,并使用 psmux 作为复用器),以及带有 flake 模块的 Nix/NixOS;还可以驱动通过 SSH 远程运行或在 WSL 中运行的智能体。
如果关闭 thurbox 或重启笔记本,工作还会继续运行吗?会。每个智能体都运行在持久的复用器会话中,即使崩溃、TUI 重启或系统重启也能保留;用 Ctrl+Q 关闭 thurbox 不会终止任何进程。
我能否在同一个会话列表中运行其他机器上的智能体?可以。主机在 hosts.toml 中声明,远程 SSH 或 WSL 会话会显示在同一列表中,并归属于各自的主机,而 TUI 本身仍在本地运行。
如何自定义界面?每个窗格和会话列表都是 ~/.config/thurbox/ 下的普通 Lua 文件,可以编辑、删除或替换;按 F10 可实时重新加载。内置的 ui-skill 扩展甚至允许你让正在运行的智能体本身帮你重新排列界面。
thurbox-cli 有什么用?它是一个无界面的配套二进制文件,可以在脚本中创建、控制、捕获和销毁会话,读写的是 TUI 所使用的同一个数据库。
多个仓库能共用一个智能体会话吗?可以。一个会话可以跨越多个仓库,每个仓库位于共享分支的各自 git worktree 上,因此智能体之间不会争用同一个检出目录;按 Ctrl+S 可将它们与各自的基础分支同步。
作者
Thurbeen
大小
507.4 MB
星标
120
时长
9个月
提交 · 90 天