Interactive TUI

Interactive TUI

Run ssm with no arguments to open the interactive terminal UI. It's built on ratatui and crossterm, with shared chrome (header/footer bars, theme, flash messages) provided by the tui-core module.

Screens

Screen	Description
List	The main session list — browse, search, filter, and connect.
Form	Add or edit a session (name, host, user, port, tags, proxy jump).
Search	Filter sessions by text (matches tags too).
TagPick	Filter the list by a specific tag (group view).
Help	Keybinding reference.
ConfirmDelete	Confirmation prompt before deleting a session.
Update	Check for and apply ssm updates.

Navigation

Standard TUI conventions: arrow keys / hjkl to move, Enter to select, Esc to go back, and q to quit. The footer bar always shows the keys available on the current screen.

Keyboard shortcuts

Key	Action
j/k	Move down/up (supports numeric prefixes, e.g. 5j)
gg/G	Go to first/last session
Ctrl-d/Ctrl-u	Half-page scroll
Ctrl-f/Ctrl-b	Full-page scroll
Enter	Connect to selected session
a	Add new session
e	Edit selected session
D	Delete selected session (prompts for confirmation)
y	Yank (copy) host to clipboard
/	Search/filter sessions (matches tags too)
T	Filter by tag (group view); Esc clears the filter
s	Open settings menu (herdr, probe, biometric, theme)
u	Reload sessions from disk
U	Check for / apply ssm updates
Space	Open which-key menu (delete, yank, tag filter, import, settings)
?	Toggle help screen
q	Quit

Which-key menu

Press Space on the list screen to open a transient leader-key popup. Press one of the listed keys to act, or Esc to dismiss:

Key	Action
d	Delete session
y	Yank host to clipboard
T	Filter by tag
i	Import SSH config
s	Open settings submenu
?	Help

Settings submenu

From the which-key menu, press s → then:

Key	Action
h	Toggle herdr mode
p	Toggle reachability probing
b	Toggle biometric unlock
t	Open theme picker

Theme picker

From settings, press t → then press the theme's mnemonic key to switch live. See Themes for available options.

Minimum terminal size

ssm requires at least a 50×10 terminal. Smaller terminals are rejected with an error message.

The TUI restores your terminal cleanly on exit — even on a panic, raw mode and the alternate screen are torn down by a guard so you're never left with a broken prompt.