UniloomDocs
Use Uniloom

The map and the list

Sessions draws the same sessions twice: as a map in the main area and as a list on the left. Read on to tell a node, a row or a colour apart.

The map#

The map is a tree with this computer at the centre: group → project → branch → session. A session with no project hangs from No project. A node shows the most urgent state of the sessions under it. Pointing at a node lights its rows in the list, and pointing at a row lights its node.

  • Click a group or project to centre it. The list narrows to its sessions, and a trail of names above it takes you back up.
  • All, a click on empty space, or Escape returns to the whole computer.
  • Click Uniloom Bot at the centre to Ask Uniloom.
  • Drag a node to reorder it; Reset layout undoes it.
  • In a window narrower than about 1024 px the map is hidden and the list shows everything.

The list#

Sessions are grouped under their group or project. One outside every project goes under its git repository's name, or else No project. Sessions that need you come first, then working ones, then idle ones. The order holds still while the pointer is in the list.

A session is listed where its edits land. If an agent edits another worktree of the same project, its row moves under that worktree's branch and says from \<folder>.

A row#

PartShows
TitleThe branch checked out in the session's folder, with its checkout marks and pull request (ui/hotfixes ↑4 #118). With no branch: the session's name, else what it was asked
Second lineThe question when it waits on you; what it said it is doing when it works; the next plan item when it went quiet with work left
Third lineThe agent's mark, time since it moved, how it runs, context fill, and its flow step (Build, Check, Waiting)

A terminal glyph means Uniloom runs the session; an eye means it runs in your own terminal and Uniloom follows. Context fill reads 8% of 258k when the agent states its window, else a count (323k).

Colours. Amber: needs you. Green: working. Grey: idle. Red: failures. Blue: live subagents.

Checkout marks.

MarkMeans
↑3Commits the branch has that its base lacks
↓1Commits the base gained since
Grey ringUncommitted work
missinggit lists the worktree, but its folder is gone
not readgit did not answer in time
owedThe session did real work and saved nothing to memory yet
Review · n filesA branch waiting for you (Review the branch)

A worktree with nothing running in it reads checked out, nothing running. One where a subagent works reads working · subagent of fix/login.

A Terminal is a row too, always grey, titled by what runs in it now (zsh, npm), with its folder under it.

Row actions#

Click a row to open the session in a temporary tab, which the next click replaces. Double-click keeps the tab. Pointing at a row shows two buttons: End, which ends the session on a second click, and ⋯, the menu:

ItemDoes
Open besideShows the session in a column beside yours (⌘-click does the same)
PR #118Opens the pull request in your browser
Hand back to my terminalOn a Claude Code session Uniloom runs (Your terminal and Uniloom)
Review & mergeOpens the review of a waiting branch
New sessionStarts a session in a new worktree of the project
Copy pathCopies the folder's path
Make a projectOn a row under No project: makes its folder a project
Copy resume commandCopies the agent's resume command, such as claude --resume <id>

A branch or project, on the map or as a heading, offers New session (+), Branch changes (what the branch changed) and, on a checkout, Run preview (Run preview).

Park hides a worktree that reads checked out, nothing running. It moves to a Parked · n line at the end of its project, with Unpark beside each. Nothing on disk changes, and the choice is kept on this computer only.

Finished and past sessions#

Just finished sits at the foot of the list for ten minutes after a session ends. A tick means its last turn finished; Stopped before it finished means it was stopped mid-turn. Click one to open its record.

Earlier today in \<workspace> folds the rest of today's sessions. All past sessions in \<workspace> → opens the whole history, newest first; Resume on a row continues it on Home.

Drag the list's edge to resize it. ⌘B hides it.

Last updated