Terminal UI
Run muxy with no arguments to open Muxy inside any terminal. It shows the
same projects and terminals as the desktop app, with its own tabs and splits.
It works on macOS and Linux, locally or over SSH.
muxy # this computer's server
muxy --host devbox # the server on another computer, over SSH
Keys
Every command starts with the prefix Ctrl-B, like tmux. Press Ctrl-B ? for
help.
After Ctrl-B | Action |
|---|---|
c | New tab in the project folder |
n / p | Next / previous tab |
1–9, 0 | Go to tabs 1–9, or tab 10 |
% | Split side by side |
" | Split top and bottom |
| Arrows | Move focus between panes |
Ctrl + Arrows | Resize the split |
r | Enter resize mode; use arrows, then Esc to leave |
o / Tab | Next pane |
z | Zoom the pane |
x | Close the pane |
s | Switch project |
( / ) | Previous / next project |
b | Toggle the sidebar |
m | Toggle mouse support |
[ | Enter scrollback |
w | Open an existing terminal of this project |
d | Detach and quit; terminals keep running |
Ctrl-B | Send Ctrl-B to the terminal |
Behavior
- The first run opens one shell in Home. After that, it restores your layout.
- Several
muxywindows share one layout, and changes in one show in the others. - Quitting or detaching never ends a terminal. Closing a pane ends its terminal unless another app still shows it, and asks first if a program is running.
- With
--host, the layout for that server is kept on this computer. - A tab holds up to 16 panes, and a project up to 64 tabs.
- The sidebar shows AI agent activity.
Mouse and scrollback
Click to focus a pane or pick a project or tab, and drag a divider to resize.
Drag across text to select it; it is copied on release. Double-click selects a
word and triple-click a line. Right-click opens a menu. When a program uses the
mouse, hold Shift to select.
Ctrl-B [ or Ctrl-B PageUp opens scrollback. Scroll with the arrows,
PageUp, and PageDown; q or Esc returns to the live screen. The mouse
wheel scrolls history too, unless the program uses the mouse or fills the
screen; then hold Shift.
Not supported
The terminal UI has no custom key bindings or project layouts, and doesn't show images in the terminal. Desktop and terminal UI layouts are kept separately.