Skip to main content
Rakumux has two modes. In session mode every key goes to the program, except Ctrl-\, which switches to Rakumux mode. The keys below are Rakumux mode keys. From inside a session, put Ctrl-\ first: Ctrl-\ n is a new session, Ctrl-\ ? opens Help.
Settings (,) lists every action with its keys, and Enter runs the one you pick.

Modes

Moving around

If Option/Alt+↑/↓ do nothing, your terminal isn’t sending Option/Alt with the key. iTerm2, Ghostty, kitty, WezTerm and Alacritty do; in Terminal.app, turn on Use Option as Meta key.

Sessions and folders

In the Feed

While the Feed has the keys (its ≡ Feed band is in the accent):

Help and app

Mouse

  • Click a session in the list to show it; click the session to work in it.
  • Click a tab at the top of the list to group the list by it; click the active one to open its modal.
  • Point at a session to show a star left of its name: click ☆ to pin it or the gold ★ to unpin it, without changing the selection.
  • Drag a session up or down the list (or a tab left or right) to move it. A click without moving just selects it.
  • Click ▸ under a session to show where it has worked; click a place to copy its path.
  • Drag the line between the list and the session to resize the list, and the line left of the Feed to resize the Feed. « Hide list at the bottom of the list hides it; the » at the left edge brings it back.
  • Click a card in the Feed to give it the keys and select it; click it again to read it whole.
  • Click the mode in the centre of the footer: SESSION MODE switches to Rakumux mode, RAKUMUX MODE goes back to the session. The footer buttons do what they say, including f ≡ Feed and a Sign in while signed out. Phones send taps as clicks, so all of this works there too.
  • The wheel scrolls the session’s history, or goes to the program when it uses the mouse itself.
  • Hold Shift while dragging to select and copy text with your terminal.

In Help and Settings

rakumux attach

rakumux attach <name|id> shows one session full screen outside the UI, which works well over SSH. Its prefix is the Rakumux key, Ctrl-\, followed by: