UniloomDocs
Use Uniloom

Sessions

Sessions shows every session of your agents on this computer, live, so you see at a glance which one needs you and which is working. It covers all 16 agents and sessions in your own terminals too. Nothing to install: a session appears within seconds of starting.

With nothing selected, the main area shows the map, and the list runs down the left. Click a row to open the session in a tab. The map and the list explains each part.

What you see#

Each live session has one state:

StateMeaning
Needs you (amber)The agent finished a turn and waits on you: it asks permission for a tool call, asks a question, or reports that it finished
Working (green)The agent wrote to its session in the last 45 seconds
Idle (grey)Quiet, and you spoke last. A session that only waits (a sleep, a scheduled wakeup) is idle too

The header counts each state. ⌘⇧J opens the session that has waited longest, then the next. When a session starts to wait for permission or an answer and Uniloom is not in front, macOS shows one notification. A finished turn posts none; it waits on Home. Turn notifications off with Tell me when a session needs me in Automations › Built-in. How a state is worked out: Status and flow.

A session that ended moves to Just finished, then Earlier today. Subagents are not sessions: the parent's row counts them.

Narrowing to a workspace or a project#

The picker above the list starts on All workspaces. Pick a workspace to keep only its sessions, in the list and the map. A session no workspace claims counts as Personal's. A second picker then narrows to one project (All projects). The choice lasts while the window is open.

A session's pull request#

Uniloom checks origin for pull requests, asking once a minute, and shows #118 on the row when one points at the branch's tip. Uniloom opens no pull requests: push and open one on your code host.

The keyboard#

Tab reaches the list's rows and Enter opens one. With focus in the list:

KeyDoes
↑ ↓ or j kMove between sessions
Home, EndFirst or last row
fStart a second agent in the row's folder
sEnd the session (press twice within four seconds)
EscapeBack to the terminal

From anywhere, ⌘K → Focus the sessions list puts focus on the first row. All keys: Keyboard shortcuts.

Ending a session#

Point at a row and click End. It turns red and reads End?; click again, or press s, within four seconds. A Claude Code session that runs as a background job keeps its conversation, so you can attach to it again. Any other session ends. End works on sessions Uniloom did not start, such as a CLI in another terminal.

Quitting Uniloom ends the sessions it hosts, except Claude Code sessions, which keep running as background jobs.

In the menu bar#

The Sessions icon in the menu bar shows a count while a session needs you. Its panel lists the sessions that work or wait on you; click one to open it. It also has Keep the computer awake, New session, Open Uniloom and Quit Uniloom. Closing the window only hides Uniloom; ⌘Q quits. The window opens again at the size and place you left it, maximised if it was, and on the main screen if its screen is gone.

More about sessions#

Last updated