thurbox (Coding-Agent TUI Orchestrator)

멀티 에이전트 오케스트레이션

여러 코딩 에이전트를 각각의 tmux 세션에서 실행하여 서로 간섭 없이 작업할 수 있습니다. 각 에이전트는 자체적인 git worktree를 사용하므로 브랜치 수준의 격리가 보장됩니다.

지속적인 세션 관리

thurbox를 종료해도 모든 에이전트 세션은 계속 실행되며, 다시 실행하면 이전 상태를 그대로 복원할 수 있습니다. 이는 tmux의 지속성을 활용한 기능입니다.

작업 트리 및 멀티 레포 지원

하나의 세션이 여러 저장소를 아우를 수 있으며, 각 저장소는 공유 브랜치의 독립적인 worktree에서 실행됩니다. Ctrl+S 키로 모든 worktree를 origin/main 기준으로 동기화하고 충돌을 자동 해결할 수 있습니다.

원격 및 WSL 세션 지원

hosts.toml 파일에 원격 호스트를 선언하면, 에이전트는 원격 머신이나 WSL 배포에서 실행되면서도 thurbox 인터페이스는 로컬에 유지됩니다.

헤드리스 CLI (thurbox-cli)

thurbox-cli는 터미널에서 세션 생성, 제어, 메시지 전달, 자동화 스케줄링 등을 수행할 수 있는 도구로, TUI와 동일한 SQLite 데이터베이스를 공유합니다.

자동화 및 작업 관리

예약된 에이전트 실행과 할 일 목록을 지원하며, tmux 하트비트가 thurbox가 실행되지 않아도 작업을 트리거합니다. 에이전트 간 메시지 전달을 위한 중립적인 메일박스 기능도 제공됩니다.

확장 가능 인터페이스

모든 UI 요소(세션 목록, 터미널 패널, 검색 스트립 등)는 ~/.config/thurbox/ui/plugins/ 디렉터리의 Lua 파일로 구성되어 있으며, 사용자는 이 파일을 수정하거나 교체하여 인터페이스를 커스터마이징할 수 있습니다. F10 키로 디스크 변경 사항을 즉시 반영할 수 있습니다.

테마 및 마우스 지원

36가지의 내장 테어마(28 다크, 8 라이트)를 Ctrl+Y 키로 실시간 전환할 수 있으며, 완전한 마우스 지원을 제공합니다.

다운로드·설치 방법

Windows PowerShell을 사용하는 경우, 다음 명령어를 실행하여 설치할 수 있습니다:

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

이 명령어는 thurbox와 thurbox-cli 바이너리를 모두 설치하며, 체크섬 검증과 플랫폼 자동 감지를 수행합니다. 설치 후 %LOCALAPPDATA%Programsthurbox 디렉터리에 설치되고, 사용자 PATH에 자동으로 추가됩니다.

또한 winget 또는 Chocolatey를 통해서도 설치할 수 있으나, 이들 채널은 최신 버전에 비해 지연이 있을 수 있으므로 최신 버전을 원한다면 PowerShell 설치 방법을 권장합니다.

설치 전제 조건으로 tmux ≥ 3.2 (네이티브 Windows의 경우 psmux), git, 그리고 최소 하나 이상의 코딩 에이전트 CLI가 필요합니다.

기본 사용법

설치 후 터미널 또는 PowerShell에서 다음 명령어를 실행하여 thurbox를 시작할 수 있습니다:

thurbox

첫 실행 시 ~/.config/thurbox 디렉터리가 생성되며, 여기서 에이전트 설정, 테마, 인터페이스 플러그인 등을 관리할 수 있습니다. 화면 왼쪽에는 세션 목록이, 오른쪽에는 선택된 에이전트 터미널이 표시됩니다.

세션을 생성하려면 Ctrl+N을 눌러 저장소 선택 → 세션 이름 입력 → 에이전트 선택 순으로 진행합니다. 작업 공간 모드(worktree)를 활성화하려면 저장소 선택 후 ‘w’ 키를 눌러 base 브랜치와 새 브랜치 이름을 지정할 수 있습니다.

에이전트와의 상호작용은 오른쪽 터미널 패널에서 직접 이루어지며, 모든 키 입력이 해당 에이전트에 전달됩니다.

두 번째 세션을 추가하려면 다시 Ctrl+N을 누르고, 세션 간 이동은 Ctrl+J(다음 세션)와 Ctrl+K(이전 세션)를 사용합니다. 현재 보고 있지 않은 세션은 계속 백그라운드에서 작업합니다.

thurbox TUI를 종료하되 세션은 유지하려면 Ctrl+Q를 누릅니다. 이후 thurbox를 다시 실행하면 모든 세션이 이전 상태를 유지한 채 복원됩니다.

모든 키 바인딩과 기능 목록은 F1 키를 눌러 실시간으로 확인할 수 있으며, 이는 현재 실행 중인 구성을 반영하므로 drift가 발생하지 않습니다.

이런 경우에 유용합니다

여러 코딩 에이전트를 동시에 활용해야 하는 개발자에게 유용합니다. 예를 들어, 한 에이전트는 코드 리팩터링을, 다른 에이전트는 테스트 작성, 세 번째 에이전트는 문서 생성을 동시에 수행할 수 있습니다. 각 에이전트는 독립된 작업 공간에서 실행되므로 서로의 작업에 간섭하지 않습니다.

원격 서버나 WSL 배포에서 코딩 에이전트를 실행해야 하지만 로컬 인터페이스를 유지하고 싶은 경우에도 유용합니다. hosts.toml에 원격 호스트를 선언하면, 에이전트는 원격에서 실행되면서도 세션 모니터링 및 제어는 로컬에서 수행할 수 있습니다.

반복적인 에이전트 작업(예: 매일 아침 이슈 트리지)을 자동화해야 하는 경우, thurbox-cli와 자동화 기능을 사용하여 스케줄된 작업을 설정할 수 있습니다. tmux 하트비트가 thurbox TUI가 꺼져 있어도 작업을 트리거하므로 신뢰성 있는 백그라운드 자동화가 가능합니다.

지원 환경·시스템 요구사항

thurbox는 Windows, Linux, macOS에서 실행됩니다. Windows에서는 PowerShell 5.1+ 이상이 권장되며, 네이티브 tmux 대신 psmux를 멀티플렉서로 사용해야 합니다.

필수 시스템 요구사항은 다음과 같습니다:
– tmux ≥ 3.2 (Windows의 경우 psmux 설치 필요)
– git
– 최소 하나 이상의 코딩 에이전트 CLI (Claude Code, Codex, Antigravity, opencode, aider, GitHub Copilot CLI 등)

이러한 조건이 충족되면, 공식 설치 스크립트를 통해 플랫폼에 맞는 바이너리를 자동으로 다운로드하고 설치할 수 있습니다.

최신 버전·업데이트

현재 버전은 2.19.9이며, 이는 Chocolatey 패키지 및 GitHub 저장소에서 확인할 수 있는 최신 릴리스입니다. 버전 정보는 GitHub 릴리스 페이지 또는 공식 웹사이트의 문서에서 확인할 수 있습니다.

제한 사항·확인 사항

thurbox를 사용하기 위해서는 tmux ≥ 3.2 (또는 Windows용 psmux)가 반드시 설치되어 있어야 합니다. 이 멀티플렉서가 없으면 thurbox는 실행되지 않거나 정상적으로 작동하지 않습니다.

또한 최소 하나 이상의 코딩 에이전트 CLI가 사전에 설치되어 있어야 합니다. thurbox는 에이전트 자체를 제공하지 않으며, 사용자가 원하는 에이전트(예: Claude Code, Codex 등)를 별도로 설치하고 구성해야 합니다.

Windows에서 네이티브 tmux 대신 psmux를 사용해야 하며, 이는 별도로 설치해야 하는 구성 요소입니다. 공식 설치 가이드에서는 psmux 설치 방법을 안내하고 있습니다.

FAQ

• thurbox는 무료로 사용할 수 있나요?

  예, thurbox는 MIT 라이선스 하에 배포되는 오픈소스 소프트웨어입니다. 소스 코드는 GitHub에서 freely 접근 가능하며, 상업적 및 비상업적 사용 모두에 제한이 없습니다.

• Windows에서 thurbox를 설치할 때 Chocolatey보다 PowerShell 설치 방법을 권장하는 이유는 무엇인가요?

  Chocolatey 커뮤니티 저장소는 중재 및 속도 제한으로 인해 새로운 버전이 반영되는 데 최대 30일이 소요될 수 있습니다. 따라서 최신 버전을 즉시 받고 싶다면, 공식 PowerShell 설치 스크립트를 사용하는 것이 권장됩니다.