sshuttlebox / shbx

SSH hosts and tunnels,
kept tidy.

A compact terminal manager for the SSH targets you actually use. Save hosts under short names, organize them into groups, run local/remote/SOCKS tunnels, and connect with one command — or browse everything from an interactive TUI.

zsh — shbx
❯shbx config init ✓Config initialized at ~/.config/sshuttlebox/config.json ❯shbx add prod --host 192.0.2.10 --user deploy ✓Host "prod" saved ❯shbx connect prod Welcome to Ubuntu 22.04.3 LTS deploy@prod:~$
shbx — interactive ui

Interactive UI

Everything you need,
without leaving the terminal.

Run shbx with no arguments to launch the TUI. Browse hosts, start tunnels, and connect — all from a single screen, with a command palette for any action.

Features

>_
Saved hosts
Connect to any SSH target by a short name. No more memorizing IPs, ports, and key paths.
◫
Interactive TUI
Browse, filter, connect, and edit hosts from a terminal UI with a command palette.
⇄
Tunnels
Local, remote, and SOCKS port forwarding with start/stop lifecycle management.
⊞
Groups
Organize related hosts and tunnels into named groups for quick filtering.
⟳
Shell completion
Bash, zsh, and fish completion for all saved host and tunnel names.
⚕
Doctor checks
Inspect config, SSH availability, keys, and tunnel state with a single command.

Commands

Hosts

shbx add <name> Save a new SSH host
shbx list List all saved hosts
shbx connect <name> Open an SSH session
shbx edit <name> Update a host's fields
shbx remove <name> Delete a saved host

Tunnels

shbx tunnel add <name> Define a new tunnel
shbx tunnel list List defined tunnels
shbx tunnel start <name> Bring a tunnel up
shbx tunnel stop <name> Tear a tunnel down
shbx tunnel remove <name> Delete a tunnel

Config & groups

shbx config init Create the local config
shbx group add <name> Create a named group
shbx group show <name> Show group contents
shbx doctor Check config and SSH state
shbx completion install Install shell completion

Quick start

1
Install the binary
$go install github.com/itaprac/sshuttlebox/cmd/shbx@latest
2
Initialize config and add a host
$shbx config init $shbx add prod --host 192.0.2.10 --user deploy
3
Connect or open the TUI
$shbx connect prod $shbx