Use the TUI
The source-built tab shell manages tabs, drafts, status, and event scrollback. It is not included in the installed headless CLI package. Typing a task in a tab currently saves a draft; it does not start an agent. To ask a model or execute Scala, use the Scala REPL or CLI.
Start
Complete the source-checkout setup first. From the repository root:
RAIDER_CP=$(cat artifacts/user-examples/classpath.txt)
RAIDER_PROVIDER=mock java -cp "$RAIDER_CP" raider.repl.Main --tabs
Run this in an interactive terminal. The banner should identify tabs mode and a scripted fixture stream. Mock mode shows demo activity without
contacting a model. If the classpath file is missing, build it with
sh scripts/build/user-examples.sh.
Open two tabs
At the raider> prompt, enter:
:new work
:new review
:tabs
:switch work
A new tab becomes focused. :tabs lists the tabs with their row numbers,
labels, status, and unread counts; the focused row has a marker. Mock activity
may update these rows while you work.
Rename the focused tab and switch between the two:
:rename implementation
:next
:prev
:next and :prev wrap around the tab list. Focusing a tab clears its unread
count. You can also switch by row number, for example :switch 2.
Keep a draft
With the implementation tab focused, type:
Check the discount boundary
The shell echoes the line and appends it to that tab's draft. Switch to another tab and back: the draft stays with its tab. Drafts are local to the running shell; they are not saved conversations, and there is currently no submit command. Scala expressions typed here are also stored as text.
Read recent events
:scrollback implementation
The command displays recent event text for that tab, including the number of
retained and evicted lines. It keeps up to 500 lines per tab. Supply a label,
row number, tab ID, or unique label prefix; bare :scrollback needs a target.
In mock mode these are demonstration events.
Close or exit
:close acts on the focused tab. For a running tab, the shell asks whether to
hide it (h) or request cancellation (c). In this standalone TUI, new tabs
have synthetic job bindings: hiding removes the tab, while the cancellation
choice reports a request without cancelling a real runtime job. A completed
tab closes directly.
Use :quit to leave the TUI. To switch to the Scala REPL, exit and launch
without --tabs:
RAIDER_CP=$(cat artifacts/user-examples/classpath.txt)
RAIDER_PROVIDER=mock java -cp "$RAIDER_CP" raider.repl.Main
Now scout.ask("Hello") is evaluated as Scala. See model setup
to replace mock replies with model responses. Configuring a live model does
not add prompt submission to the tab shell.
Command reminder
| Command | Action |
|---|---|
:help | Show the available commands |
:new <label> | Create and focus a tab |
:tabs | List tabs |
:switch <number-or-label> | Focus a tab |
:next, :prev | Move focus |
:rename <label> | Rename the focused tab |
:scrollback <tab> | Show recent event text |
:close | Close or hide the focused tab |
:quit | Exit |
Type a command prefix such as :sw and press Tab for completion.