tmux
Open a remote tmux session in control mode and drive its windows as native local panes (beta).
Beta: tmux integration is under active development. The core workflow is stable but some edge cases are rough.
DiceTerm can open a remote tmux session and render its panes as native local xterm panes — not a screen scrape, not an SSH passthrough. You get real local rendering with proper color, scrollback, and resize support.
How it works
Click the tmux button on any saved server. DiceTerm opens a full-screen overlay and runs:
ssh -t user@host -- tmux -CC new -A -s diceterm
The -CC flag starts tmux in control mode: tmux sends structured events over the SSH connection and DiceTerm renders each pane locally using xterm.js. There is no per-keystroke round-trip for display — each pane behaves like a local terminal.
The window bar
A bar at the top of the overlay lists the tmux windows in the session. Click a window to switch to it. Click + to create a new window.
Limits
| Limitation | Detail |
|---|---|
| One control session per server | Opening a second tmux overlay to the same server reattaches the existing session |
| Fixed session name | The session is always named diceterm; you cannot change this from the UI |
| Prefix key passthrough | tmux prefix keys (e.g. Ctrl+B) pass through to the remote tmux as normal |
Requirements
- tmux must be installed on the remote server.
- The saved server must have SSH access configured (see SSH).
- A working Windows OpenSSH client (used to establish the connection).
Tips
Tip: Because DiceTerm attaches with
new -A, it creates thedicetermsession on first connect and reattaches on every subsequent connect. Your remote processes keep running even when you close the overlay.
See also
- SSH — configure saved servers and authentication