Mercury CLI
Documentation

Start

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 Esc returns 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+← and Shift+→ 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:

  1. Select New Session on the Boot face.
  2. 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:

  1. Enter /concourse.
  2. Select a session row.
  3. 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:

  1. Start Mercury with mercury --chat.
  2. Select New Session.
  3. 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.

Overview, Quickstart, Sessions, Slash commands, Permission modes