The window
The window has four regions:
| Region | Position | Contents |
|---|---|---|
| Sidebar | Left, full height | JOJO logo, the Needs you queue, locations, projects and sessions; Remote location and Settings at the bottom |
| Tab row | Top right | Session cards, +, Snippets and Search |
| Panes | Middle right | One terminal per pane; the focused pane is outlined in the accent color |
| State strip | Bottom right | Session counts per state |
Sidebar
- The Needs you queue at the top lists every session waiting for your answer, from every location, longest wait first. Each row shows the session's name, how long it has waited and what it is asking, for example a permission prompt. Clicking a row focuses that session's pane. The queue is hidden while nothing is waiting.
- Locations follow: your computer first, then each remote location. A location heading shows a dot (green when connected) and the location's name, followed by its connection status when it is not connected.
- Under each location are its projects. A project is a folder on that location; sessions started in a project start in its folder.
- Under each project are its sessions. A session row shows its state badge, its name, a context meter for Claude Code sessions, and how long it has been in its current state.
- At the bottom, Remote location adds a Linux server and the gear opens Settings.
The sidebar's right edge can be dragged to resize it between 200 and 480 pixels. Double-clicking the edge returns it to 268 pixels. With the edge focused, Left and Right change the width in 16-pixel steps.
Tab row
Each tab of the selected project is a card for the session in its focused pane. A card shows the session's name, the number of panes when there is more than one, how long the session has been in its current state, the state in words and in its color, and what the session is asking (or the project's name). To the right of the cards are + (a new terminal in the selected project), the Snippets button (a command-prompt icon) and the Search button (a magnifier).
Panes
Each pane shows one session's terminal under a header strip. The focused pane has a border and glow in the theme's accent color. A pane whose session is working, needs you, is done or failed takes that state's color on its border, glow and header; a pane that needs you pulses.
Session states
| State | Meaning |
|---|---|
| Starting | Claude Code is starting in the session. |
| Idle | Claude Code is waiting at its prompt for a new message. |
| Working | Claude Code is working on a request. |
| Needs you | Claude Code is waiting for your answer, for example to approve a tool or answer a question. |
| Done | Claude Code finished its turn. The badge stays lit until you type in the pane. |
| Error | Claude Code's turn failed. |
| Running | A shell session. Shells report no states of their own. |
| Exited | The session's program ended. Hovering the badge shows the exit code. |
States come from Claude Code's hooks, so a shell in which you start claude by hand also reports them while Claude Code runs.