What is thurbox
thurbox is a terminal interface on top of one or more Fleets. It shows every session of every Fleet in one list, with the agent's live terminal beside it, and lets you create, switch, message and delete sessions from the keyboard.
- Fleet runs the sessions. thurbox keeps no session state: every session is a Fleet Task. Quit thurbox and the agents keep running.
-
One list, several Fleets. Follow a Fleet on this machine and others over ssh
or WSL, listed in
~/.config/thurbox/settings.toml(Fleets). - The interface is yours. Every pane, the session list included, is a Lua file you can move, turn off, replace or write (The interface).
First steps #
- Install thurbox. The install script installs Fleet with it.
-
Run
thurbox. On a machine with no Fleet config, it runsfleet initfirst, and it startsfleet upon this machine when no manager runs. - Press Ctrl+N: pick a place, a repository, a name and an agent. The tutorial walks through it.
What thurbox keeps #
Only how you look at things: session order, seen marks, bookmarks, theme, keybindings and
settings, as plain files under ~/.config/thurbox/ and
~/.local/share/thurbox/. Everything about a session is
Fleet's. thurbox-cli covers the interface's own files: doctor,
config, plugin, ui, version and more.