Home

ssm Wiki

ssm is a standalone SSH session manager with a terminal user interface (TUI), built in Rust. Store, browse, and connect to SSH sessions with vim-inspired keybindings, secure password storage, and customizable themes.

Repository: CtrlUserKnown/ssm · Releases: latest

What it does

• Session Management — Add, edit, delete, and search SSH sessions from a rich TUI or the CLI.
• Secure Password Storage — Passwords live in the OS keychain (macOS Keychain / Linux Secret Service), never on disk; supplied to ssh (and herdr) at connect time via SSH_ASKPASS, never on the command line.
• Optional Biometric Unlock — Off by default; when enabled, a fingerprint/Touch ID check gates password reveal at connect time.
• SSH Config Import — Pull hosts straight from your existing ~/.ssh/config.
• Tags & Group Views — Label sessions and filter the list down to a tag.
• Jump Hosts — Per-session ProxyJump support (ssh -J).
• Live Reachability — Background TCP probes show per-host latency, color-coded status, and a latency sparkline.
• Vim-Style Navigation — j/k, gg/G, Ctrl-d/Ctrl-u, numeric prefixes (5j), and a which-key menu system.
• 7 Built-in Themes — auto, noir-cat, knew-pines (Rose Pine), catppuccin, gruvbox, nord, tokyo-night.
• Two Connection Modes — Plain SSH or via herdr helper.
• CLI Interface — Direct connection, session listing, and config import without the TUI.
• Self-Updating — Built-in update checker and one-command upgrade from GitHub Releases.

Documentation

Page	Contents
Installation	Install script, building from source, prerequisites
CLI Reference	Every flag and subcommand
Interactive TUI	The terminal UI and its screens
Configuration	config.toml and the DOTS_SSM_DIR override
Security	Password storage, SSH_ASKPASS, biometric unlock
SSH Config Import	Importing hosts from ~/.ssh/config
Themes	Available color themes and how to switch
Updating	How update checks and self-upgrade work
Development	Building, testing, and project layout

---

Maintained by CtrlUserKnown / Charlynder