Mobile Sessions
Luvus automatically changes its presentation for narrow terminal viewports. No
--mobile flag is required. Direct SSH, luvus --remote, local sessions, and
named sessions all use the same viewport rule.
At 64 columns or fewer by default, Luvus shows one focused pane below a two-row mobile header. Desktop sidebars, tabs, pane titles, status rows, and Luvus Bars stop consuming terminal space. Their important navigation and status remain available through the two-row OPEN MENU button.
When the current tab has multiple panes, the header surrounds the active pane
label with ‹ and ›. Tap the left half of that row for the previous pane or
the right half for the next pane. Pane focus wraps within the current tab.
Navigate on a phone
Section titled “Navigate on a phone”Tap MENU to open the full-screen Mobile Navigator. It provides:
- agents in the active workspace, ordered by urgency;
- tabs from the active workspace and a global list of workspaces;
- fuzzy filtering as soon as you type;
- All, Agents, Tabs, and Workspaces scopes;
- new tab, open workspace, Settings, Mission Control, update information, and Exit;
Each result uses a two-row touch target. The primary row aligns the state and
name from the left; the secondary row shows workspace, tab, pane, branch, or
action detail. Actions use the same card-like hierarchy and explain their
destination on the second row. Compact section rules keep the list easy to scan.
The CLOSE MENU button is a fixed 7x2 control. Empty space does not close
the navigator, so an imprecise tap cannot drop you back into a mouse-aware
terminal application. Arrow keys, Tab, Enter, typing, Backspace, and Escape
remain fully supported when mouse input is unavailable.
Selecting another workspace closes the navigator. The next time you open it, Agents and Tabs are rebuilt from that active workspace; Workspaces continues to show the whole running session.
Exit appears after Changelog and behaves like Ctrl+Space q. In a server-backed
session it detaches the current client while the server and panes keep running.
In a --local session it exits the local process without leaving a persistent
server running.
Mobile Settings places all seven section tabs in an equal-width three-column
grid, so every tab remains aligned and tappable. With a keyboard, Tab and
Shift+Tab cycle sections and number keys 1 through 7 jump directly.
Configure unusual terminal widths
Section titled “Configure unusual terminal widths”Some phone terminals report more columns by shrinking their font. For example,
a Termius viewport may report 79x35, which stays in desktop presentation with
the default 64-column boundary. Open Settings → Layout → Mobile width and set
it to 80 if you want that viewport to use mobile presentation.
The setting is inclusive. A value of 64 means both 64 and narrower are mobile;
65 remains desktop. Lower the Settings value past 24 to select Off, or set
layout.mobile_width to 0 in config.json, to disable automatic mobile
presentation. Older layout.compact_width values are read automatically and
saved back under the new name.
Font size still belongs to Termius or the SSH client. Increase the terminal font there if text is physically small; Luvus controls the layout and hit targets, not the terminal’s glyph renderer.
Desktop and phone at the same time
Section titled “Desktop and phone at the same time”Each attached client resolves its own layout from its viewport. A phone can show the mobile interface while a laptop attached to the same Luvus server keeps the desktop interface. A passive client render does not resize the shared PTY or replace the active client’s mouse geometry.
For host setup and SSH options, see Remote Sessions.