Three-minute quickstart
1. Add a host
Use the guided terminal form:
sshnav add
Or add the same host non-interactively:
sshnav host add \
--alias prod \
--hostname 10.0.0.10 \
--user ubuntu \
--identity-file ~/.ssh/prod
The identity is validated, encrypted, and copied into sshnav's SQLite database. The source path remains metadata so doctor can explain where the key originated.
2. Open the picker
sshnav
Start typing to fuzzy-filter the inventory. Press Enter to connect.
| Key | Action |
|---|---|
| ↑ / ↓ | Move through results |
| Enter | Connect |
| Ctrl+A | Add a host |
| Ctrl+E | Edit the selected host |
| Ctrl+D | Duplicate the selected host |
| Esc | Exit |
3. Connect directly
The picker is optional. Every host is addressable by alias:
sshnav connect prod
sshnav constructs an argument vector and launches ssh directly. It never interpolates the connection into a shell command.
4. Transfer a file
sshnav send prod ./release.tar /srv/releases/
sshnav receive prod /var/log/app.log ./logs/
Add -r or --recursive for directories. Transfers reuse the host's user, hostname, port, options, jump route, and encrypted identity.