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 или любой CLI, который вы опишете сами, — каждый в своей постоянной сессии, которая продолжает работать после выхода из TUI.
Это заменяет tmux или работает поверх него?Работает поверх терминального мультиплексора: thurbox управляет сессиями, но для того, чтобы агенты оставались живыми между перезапусками, ему нужен запущенный tmux (или psmux/RMUX как альтернативы).
Как это запустить?Запустите скрипт установки в Linux/macOS или команду PowerShell в Windows — они установят и TUI thurbox, и headless-исполняемый файл thurbox-cli с проверкой контрольной суммы. Также пакеты есть для Nix/NixOS, Homebrew, AUR, winget и Chocolatey.
Что нужно установить до запуска?tmux 3.2+ (или psmux 3.3.7+ в нативной Windows, либо RMUX 0.10.0+ как альтернатива, которую нужно включить вручную), git и хотя бы один CLI агента для программирования, например Claude Code или Codex.
Достаточно ли удалить исполняемый файл, чтобы деинсталлировать это?Нет — если просто удалить исполняемые файлы, сессии в мультиплексоре продолжат работать, а хуки и навыки останутся в конфигурационных каталогах ваших агентов, поэтому нужно выполнить отдельные шаги удаления.
Работает ли это на Windows, или только на Linux/macOS?Поддерживаются Linux, macOS, Windows (через установку в PowerShell и psmux как мультиплексор) и Nix/NixOS с модулем flake; также можно управлять агентами, работающими удалённо по SSH или внутри WSL.
Продолжит ли работа идти, если я закрою thurbox или перезагружу ноутбук?Да — каждый агент работает внутри постоянной сессии мультиплексора, которая переживает сбои, перезапуски TUI и перезагрузки; закрытие thurbox комбинацией Ctrl+Q ничего не останавливает.
Можно ли запускать агентов на другой машине из того же списка сессий?Да: хосты объявляются в hosts.toml, а удалённые сессии SSH или WSL отображаются в том же списке под своим хостом, при этом TUI остаётся локальным.
Как настроить интерфейс?Каждая панель и список сессий — это обычные Lua-файлы в ~/.config/thurbox/, которые можно редактировать, удалять или заменять; F10 перезагружает их на лету, а встроенное расширение ui-skill позволяет даже попросить самого запущенного агента перестроить интерфейс за вас.
Для чего нужен thurbox-cli?Это headless-утилита, которая создаёт, управляет, снимает вывод и завершает сессии из скрипта, читая и записывая ту же базу данных, что и TUI.
Могут ли несколько репозиториев использовать одну сессию агента?Да — одна сессия может охватывать несколько репозиториев, каждый из которых размещён в собственном git worktree общей ветки, поэтому агенты не конфликтуют за одну рабочую копию, а Ctrl+S синхронизирует их с базовой веткой.
Какие есть похожие проекты?shipyard, worktrunk, MiMo-Code, openrig, fractal, hyperfide-oss, gastown, emdash
Автор
Thurbeen
Размер
507.4 MB
Звёзды
120
Возраст
9 мес
Коммиты · 90 дней