Using it
The terminal UI
Projects, the sessions in one, and the terminal of the session under the cursor: what is on screen, and every key.
What is on screen
Three columns with no borders: your projects, the sessions in the selected one, and the terminal of the session under the cursor. The top line counts what wants you, for example 1 needs you · 1 unread · 2 working, or says all quiet. The bottom line says where you are and what the keys do.
A session’s row is a status dot, a name, and in dim type the branch of its worktree, how long ago its status changed, and what kind it is. The list orders itself: what needs you first, then what finished, then what is working.
Where the keyboard is
In one of three places at a time. In the two lists, letters are verbs. In the terminal, every key goes to the session, so an agent’s own keys all work. Exactly three are held back there: ^q to get out and ^a, the leader.
Keys
The lists move the way Vim does.
| Key | What it does |
|---|---|
| j k ↑ ↓ | Move through a list. A count first works: 3j. |
| gg G | The first row, the last. 5G is the fifth. |
| ^d ^u | Half a page down, up. ^f and ^b, a whole one. |
| / | Find a row by name. ^n and ^p go to the next match and the one before, ⏎ keeps it, esc goes back. |
| h l ← → tab | Go left, right: projects, sessions, the terminal. |
| ⏎ | Open the selected session and type into it. |
| ^q | Leave the terminal, back to the lists. |
| n | Start a session: Claude Code, Codex, a shell, or NeoVim. |
| s | A shell in the project’s checkout, straight away. |
| t | A shell beside the selected session, in its worktree. |
| e | NeoVim beside the selected session, in its worktree, or on a project, in its checkout. |
| a | Add a project. |
| r | Restart the selected session. |
| x | End a session, or forget a project. |
| ^a | Then a key: commands from anywhere. ^a ? lists them. |
| ? | The keys. |
| q ^c | Leave. Your sessions keep running. |
NeoVim
NeoVim is a kind of session, like an agent or a shell. e on a session opens it beside that session, in its worktree, which is how you read and fix what an agent wrote without leaving. e on a project opens it in the project’s checkout, and ^a e does the first from inside a session.
The pane is a terminal NeoVim runs in as it would anywhere, so vim . in a shell works too, with your own config. And a session is told its EDITOR is NeoVim when you have set neither VISUAL nor EDITOR yourself, so a commit message or an agent’s long prompt opens in it.
Scrolling back
^a [ turns the keyboard from typing to reading, tmux’s copy mode for the same hands. The keys that move through the lists move the view: j k, ^d ^u, ^f ^b, gg G, with counts. The pane’s head says how far back you are, as [120/340]. Nothing you press reaches the session, the view stays where it is while the session keeps writing, and q, i or esc hands the keyboard back, as in NeoVim’s own terminal. A program that draws its own screen, NeoVim among them, has nothing above it to scroll: it scrolls itself.
The splash
The splash shows Hex beside the Voodoo wordmark, over the same purple crescent, bats, fog, and graveyard as the website. Hex is a picture in terminals that support one and half blocks elsewhere.LU_NO_MOTION holds everything still.