Skip to content

The terminal app

remotxai tui opens the sessions of the computer you’re on in your terminal. It fills the window: the session list, then one session with its transcript on top, the cards that wait on an answer above the message box, and a status line at the bottom. The command is described here.

Fullscreen is the default. It falls back to the inline view when the output isn’t a terminal, when TERM is dumb or empty, when the window is smaller than 40 columns by 12 rows, in iTerm2 under tmux -CC, and when fullscreen fails to start (the terminal is left as it was, and one line says so). Set REMX_TUI=inline to use the inline view always. A screen reader works better in the inline view.

Key What it does
Up, down, enter Choose a session in the list and open it.
tab or ctrl+k Go between the list and the open session.
esc Interrupt a running turn. With nothing running, go back to the list.
ctrl+c twice, ctrl+d Leave.
shift+tab Lower the session’s mode.
PgUp, PgDn, ctrl+p Scroll the transcript half a screen. ctrl+p pages up. The mouse wheel scrolls too.
Up, down Scroll one row when the composer has no text to move through or prompt to recall.
home, end, ctrl+u With an empty composer, go to the first row, go to the last row, or page up.
ctrl+home Go to the first row.
ctrl+end Go to the last row and follow new output again.
ctrl+f Copy the newest reply. If it has code, 1 to 9 copies that block and ctrl+f again copies the whole reply.
ctrl+y Hand the mouse to the terminal, or take it back.
ctrl+o Review the transcript. See below.
1, 2, p Allow once, deny, or open the presence window on a card.
ctrl+b Open the list of the session’s sub-agents. enter opens one’s transcript, esc goes back.
? Show every key. On the list, or as the first character of an empty message.

The keys that answer cards, the presence window keys (ctrl+w, ctrl+g, ctrl+t, ctrl+l, ctrl+x) and the / and @ menus in the message box work as they do in the inline view. Pasting a path or dropping a file attaches it.

The bottom row keeps state on the left and at most three key hints on the right. The state is the computer, the device, the session’s mode, the queue, how much of the context window is used (a small bar that turns yellow from 70 percent and red from 90) and, while the session has sub-agents, a chip such as 2/5 sub-agents (running over total). A presence prompt shows there while one is open. ? lists every key. On a narrow terminal whole parts drop, the least important first, and the row never wraps.

The chip and ctrl+b open a list of the session’s sub-agents with each one’s name, state and last activity. enter or a click on a row opens its transcript, with the prompt it was given. The list and the transcripts are read-only: no key and no click in them interrupts or stops a sub-agent. The session header shows the same count next to the mode.

The app takes the mouse while it runs.

  • The wheel scrolls the transcript, three rows a turn by default. When the view reaches the oldest loaded message, the next older page loads by itself and the view keeps its place.
  • A click on a session in the list opens it. A click in the message box puts the caret there.
  • A click on the first row of a tool call opens or closes its arguments. A call whose input the computer withheld never opens.
  • A click on a prompt picks its turn. A second click lets it go.
  • When you’ve scrolled up, a pill at the bottom counts the rows that arrived below. Click it, or press ctrl+end, to jump back. The prompt of the turn you’ve scrolled past sits dim on the top row, and a click on it goes to that turn.
  • Cards have buttons: Allow once, Deny, Open window and the question buttons. A button presses the same key, after the same short delay, and a click that starts on one button and ends on another does nothing.

REMX_TUI_MOUSE=wheel gives the app only the wheel, and off gives it nothing, so the terminal selects and scrolls as usual.

Drag to select. Double-click picks a word, and a path or a URL counts as one word. Triple-click picks a line. The selection shows in reverse video and copies when you let go.

What lands on the clipboard is what the agent wrote. Wrapped rows copy as one line, a quote copies without its bar, code copies without its gutter, a table copies by cell, and the padding after a row never copies.

The copy goes to the computer’s clipboard tool. Over SSH, or when no tool takes it, the terminal gets an OSC 52 write instead, cut at 100,000 bytes with a notice. The status line says copied when it’s done.

Your terminal can still select by itself while the app has the mouse. Hold the bypass key while you drag: Option in iTerm2, Fn in Terminal.app and Shift elsewhere. The first drag names it. ctrl+y releases the mouse for as long as you want.

A markdown link, an autolink, a web address and an absolute file path in the agent’s text are links. Only http, https, file and mailto addresses count, and only when they’re clean.

  • Ctrl+click opens a web link in your browser. In Ghostty and Warp a plain click does too. iTerm2, kitty and Terminal.app keep their own Cmd+click.
  • A file link is shown in your file manager and never opened, so a click can’t run it.
  • Over SSH, without a display, and for mailto, the click copies the link instead.
  • The same link opens at most once a second.

A right click opens a menu for what’s under it.

On Items
A selection Copy, Copy as markdown.
A link Open link, Copy link.
A tool call that can open Expand or Collapse, Copy input, Copy output.
Any other row of a turn Copy prompt, Copy turn, Copy turn as markdown, Jump to prompt.

Up and down move, enter picks, esc or any other key closes it, and a click away closes it and does nothing else. While a menu is open the message box and the cards take no keys. No item answers an approval or a question.

ctrl+o turns the transcript into a read-only view with a bar on the bottom row. The message box and the cards stand down until you leave, so no key you press there can send a message or answer a card. In the inline view, ctrl+o opens the live views of sub-agents and background processes.

  • / starts a search. Type the words, and the view jumps to the first match at or below the top of the screen as you type. The search ignores case and matches inside one printed row.
  • enter keeps the search. esc while typing leaves review mode.
  • n goes to the next match and N to the previous one, wrapping at either end. The match shows in reverse video and the view scrolls to it. The bar counts them, as in 3 of 12.
  • Up, down, PgUp and PgDn scroll.
  • [ prints the whole transcript to the terminal’s own scrollback: the app leaves the fullscreen view, prints every turn with its tool calls open, and waits. Scroll back, search and select with the terminal’s own tools. esc, ctrl+o or ctrl+c returns to the app.
  • esc or ctrl+o leaves review mode.

The search covers the transcript as it was when you pressed /. Output that arrives meanwhile is searched the next time.

These are environment variables you set in your shell, on the computer where you run the app.

Variable Values What it does
REMX_TUI fullscreen, inline, auto Which view to use. auto and unset mean fullscreen when the terminal can hold it.
REMX_TUI_MOUSE on, wheel, off What the app takes from the mouse. Default on.
REMX_TUI_FULL_REPAINT 1 Send every cell of every frame. Try it when a terminal leaves stale fragments, as Windows Terminal can.
REMX_TUI_SCROLL_SPEED 1 to 20 Rows per wheel turn. Default 3.
REMX_TUI_REDUCED_MOTION 1 Ask for a still spinner and no eased scrolling. The fullscreen view has neither yet, so it changes nothing today.

A value the app doesn’t know is the default.

tmux needs set -g mouse on, or the wheel scrolls tmux and not the app. Hyperlinks need tmux 3.4 or later with hyperlinks on in terminal-features, and an OSC 52 copy needs set-clipboard on. Over SSH the app never starts a program on the computer for a click, so a click on a link or a file path copies it.