Using Mercury
Mercury's interactive interface displays sessions through the Boot face, the chat and the Session Concourse. The strip connects the screens that currently exist.
Screens
- Boot face: A bare interactive boot lands on this screen with no chat behind it. Its menus open in place as layers of the face, and
Escreturns to their row. - Chat: This screen displays the focused session's conversation and tool calls. Tool output appears as a compact card or as full output according to the Tool output row in
/config, and the choice is saved for later boots. - Session Concourse: This board displays the current project's live sessions and, beneath them, its parked chats. A live row's NOW cell shows the reply's last line or the tool the session is running.
- The strip:
Shift+←andShift+→move to the nearest existing screen in the chosen direction. A chat joins the strip when a session is focused and leaves it when the last chat closes. The dim key-map row names only the moves that exist.
Boot face rows
- New Session: Creates a blank session in the current folder on the model shown in the chip.
- Continue Last Session: Returns to the newest chat. The row appears once session history exists.
- Boot Menu: Opens the boot settings. Its Performance section holds the Motion row, and its Agents section holds the per-session Sub-agents and Workflows switches.
- MCPs & Skills: Controls what the next session loads.
- Agents: Opens the Agent Studio to create and edit agents.
- Doctor / Health Check: Opens the installation's health certificate.
- Saturn Scheduler: Opens the schedule board as a layer of the face.
- Logins: Opens the sign-in catalogue.
- Session Concourse: Opens the project board as a separate screen.
- Sessions · Projects: Opens the combined session and repository picker.
A prompt argument, --continue or --resume opens the chat directly. The MERCURY_CONCOURSE policy changes where a boot lands: always makes the board the boot home, and auto lands on the board when more than one session is live or one is waiting on the user.
Open a session
To open a session, follow these steps:
- Select New Session on the Boot face.
- Press
Enter.
The session opens in the chat and gains its board row without sending a message.
Move from the chat to another session
To move from the chat to another session, follow these steps:
- Enter
/concourse. - Select a session row.
- Press
Enter.
The selected session becomes the focused chat while every other session's runner keeps working.
On the board, → opens a peek at the selected live row. Esc returns to the focused chat when one exists; when none does, it returns to the Boot face, as the board legend reads.
Boot without the Session Concourse
To boot without the Session Concourse, follow these steps:
- Start Mercury with
mercury --chat. - Select New Session.
- Press
Enter.
The strip holds the Boot face and the chat, and Shift+← returns from the chat to the face directly.
--concourse-off saves that choice for every later boot. --concourse-on or the Session concourse row in /config turns the board back on, and with both switches on one line the later one wins. /concourse remains available as a plain live view of the sessions.
Related pages
Overview, Quickstart, Sessions, Slash commands, Permission modes