Keybindings Reference

⌨️ Keybindings Reference

This reference documents all keyboard shortcuts available inside the neossh interactive terminal user interface (TUI).

---

Complete Keybindings Table

Key	Action	Read-Only Safe?	Description
Enter	SSH Connect	✅ Yes	Open native SSH connection to selected server
Space	Select / Toggle Group	✅ Yes	Toggle multi-selection on server ([✓] / [ ]) or expand/collapse group
Ctrl+A / *	Select All / Group	✅ Yes	Toggle select all displayed servers or toggle select servers in focused group
Esc	Clear Selection / Return	✅ Yes	Clear multi-selection if active, otherwise return to search bar
/	Search	✅ Yes	Open fuzzy search input bar
a	Add Server	🔒 Blocked	Open modal form to add a new server entry
e	Edit Server	🔒 Blocked	Open modal form to edit selected server configuration
d	Delete Server	🔒 Blocked	Safely delete selected server with confirmation dialog
i	Import Known Hosts	🔒 Blocked	Import discovered hosts from ~/.ssh/known_hosts
Shift+I	Known Hosts Manager	🔒 Blocked	Inspect, search, and delete host key entries from ~/.ssh/known_hosts
m	Context Menu	🔒 Blocked*	Toggle hidden server (on server) / Group tmux menu (on group)
Shift+H	Toggle Hidden	✅ Yes	Toggle visibility of hidden servers in the list
p	Pin / Unpin	🔒 Blocked	Pin or unpin server to top of list
Shift+P / Ctrl+G	Git SSH Profiles	🔒 Blocked	Open Git SSH Key Configuration & Profile Switcher
Shift+D / D	Dotfiles Sync	🔒 Blocked	Deploy and sync personal dotfiles to remote host via chezmoi archive
t	Edit Tags / Bulk Tags	🔒 Blocked	Edit tags for focused server, or bulk edit tags across all selected servers
Shift+X / X	Command Snippets & Runner	✅ Yes	Open command snippets library & multi-server execution runner
Shift+T	Toggle Theme	✅ Yes	Cycle themes: Dark → Light → System
c	Copy SSH Command	✅ Yes	Copy full connection command to system clipboard
o	SCP Modal	✅ Yes	Open SCP command generator to copy upload/download commands
Shift+M	SSHFS Modal	✅ Yes	Open SSHFS remote mount generator to copy mount commands
Shift+C	Key Comment	🔒 Blocked	Inspect and edit SSH public/private key comment
l	Agent Load	🔒 Blocked	Load server identity key into system ssh-agent
u	Agent Unload	🔒 Blocked	Unload server identity key from ssh-agent
Shift+L	Agent Inspector	✅ Yes	Inspect live keys loaded in system SSH agent
v	Paste SSH Command	🔒 Blocked	Parse SSH command from clipboard into Add form
y	Clone Server	🔒 Blocked	Duplicate server configuration with automatic alias deduplication
Shift+K	Kill / Deploy Key	🔒 Blocked	Kill session (Active panel) / Run ssh-copy-id (Servers panel)
f	Port Forwarding	✅ Yes	Open interactive SSH port forwarding & tunnel assistant
Shift+F	Launch SFTP	✅ Yes	Launch configured SFTP / external file manager
Ctrl+F	Dual-Pane SFTP	✅ Yes	Open built-in dual-pane SFTP manager directly
s	Toggle Sort	✅ Yes	Cycle sort mode (Alias A-Z, Z-A, Last SSH)
g	Ping Server	✅ Yes	Ping selected server and measure round-trip latency
Shift+G	Ping All / Selected	✅ Yes	Parallel ping all servers or only selected servers with color-coded latency badges
Shift+W / Ctrl+P	Ping Watch	✅ Yes	Toggle periodic background ping watch mode (default: 60s)
Tab / Shift+Tab	Cycle Panels	✅ Yes	Move focus through Search, Servers, Active, Details panels
0	Focus Search	✅ Yes	Jump focus directly to search bar
1	Focus Servers	✅ Yes	Jump focus directly to servers list
2	Focus Active	✅ Yes	Jump focus directly to active sessions list
3	Focus Details	✅ Yes	Jump focus directly to details panel
j / k or ↓ / ↑	Navigate	✅ Yes	Move cursor up / down in server or session lists
q / Ctrl+C	Quit	✅ Yes	Exit neossh

---

Read-Only / Viewer Mode (-r)

When launched with --readonly or -r:

• All modifying actions (a, e, d, D, y, v, t, Shift+C, Shift+K, i, p, l, u, Shift+P) are safely blocked.
• Attempting any restricted keybinding displays a clear informational dialog explaining that read-only mode is active.
• Safe exploration, search, SSH connecting, command copying, and monitoring operations remain fully accessible.