← use cases · scale-up
Graduating from tmux panes
Move from counting tmux panes to querying an event log once the fleet outgrows your screen.
who it's for
Anyone already running agents in tmux + bash who has hit the point where they cannot tell what each pane is doing.
the problem
tmux + scripts is the honest baseline and it works — until "which pane is on what" is bigger than your screen and a laptop sleep loses half your sessions.
how brat does it
- 1
Keep your agents; brat drives the same CLI binaries you already run.
- 2
Replace the bash bookkeeping with a structured convoy → task → session model.
- 3
Ask brat status "what is task #14 doing" instead of grepping a scrollback.
- 4
Let state survive a sleep or crash because it lives in refs/grite/*, not in a terminal buffer.
the outcome
The same agents you already trust, now with durable state, a merge queue, and a query interface — the 20% that tmux never gave you.