Skip to main content
TYBA has four stacked layers. Understanding their order clears up 90% of the confusion for anyone who just opened the app.
The interface calls a workspace a “session”. The sidebar, the context menu (Rename session, Session options) and the palette (Search sessions…) use the word “session” to talk about the workspace — not the shell.In this documentation, workspace is the layer and session is the process. When you see “session” on screen, most of the time it’s the workspace.

​
The sidebar

⌘B on macOS, Ctrl+Shift+B on Windows and Linux. Also the icon to the left of the header. It lists workspaces, not tabs. Top to bottom:
The gear is at the top, in the System group — not in the footer.

​
What the toggle does

⌘B switches between open and a second state you choose in Settings → Collapse panel: It’s not a three-way cycle — it’s an on/off between open and the option you picked.

​
Hover preview

Hovering a workspace in the sidebar opens a card with status (Running / Idle, or the agent’s state), the runner, the folder, the branch, the diff and the tab count.
That preview is the sidebar’s. Hovering a tab shows nothing — a tab only has the tooltip for its numeric shortcut.

​
Two toggles that change the density

In Settings → Preferences:

​
The header

A thin strip at the top. Left to right:

​
The inbox

The tray icon in the header, with a violet counter when something is pending. It’s where agent approvals go through. Each item shows the risk, the command, the session and the folder — and clicking the session row takes you there. With the inbox open, 1 2 3 decide the first one in the queue.
A red action takes two clicks. Approving a high-risk command turns the button into Confirm — only the second click resolves it. And red never has “Always”.
When empty, it says: All caught up. Agent session notifications arrive here. When the last approval is gone, it closes by itself.
The inbox has no shortcut. Only clicking the icon opens it.

​
The chip bar

A 24px strip at the terminal’s footer, on by default. It’s what the Chip bar preference controls. Six chips exist — and “diff” is really two: Default: Uncommitted changes and Review worktree diff on the left; ahead/behind, branch, folder and clock on the right.

​
Rearranging

With the bar on, the Bar chips editor appears: drag between Left, Right and Hidden. Restore defaults brings back the original arrangement — but it does not turn the bar on or off. It works from the keyboard: space picks the chip up, the arrows move it, space drops it, Esc cancels.
The bar also hosts the Rich Input button (⌘⇧G / Ctrl+Shift+G) when the session is eligible. It isn’t a chip and doesn’t show up in the editor.

​
Where to go next

Tabs and workspaces

The difference between the two, and what each one lets you do.

Split panes

Split, navigate, resize.

Command palette

The two palettes and the difference between them.

Shortcuts

The whole list, and how to remap.