max-rh/sshelf v0.12.0

0.12.0 — 2026-08-21

on GitHub

Release Notes

Added

• tmux mode — set tmux = "window" or "pane" (in config.toml, or on the F2 settings
  screen) and, when sshelf is running inside tmux, Enter opens the host in a new tmux window
  (named after it) or a new pane and leaves you in the picker, so you can fire off several
  connections in a row. Outside tmux, or with the default "off", connecting is unchanged:
  tear down, hand the terminal to ssh, exit to your shell. Frecency is recorded before the
  window opens, exactly as before the exec(). Hosts whose authentication would have to travel
  through tmux's command line — a
  2FA verification
  code, or a stored secret in vault mode — connect in place instead and say why; only the
  askpass wiring (never a secret) is ever passed to tmux. No new dependencies: sshelf runs your
  own tmux binary.
• Transfer: mark several and send them at once — Space marks the file or folder under the
  cursor, Ctrl-a marks everything the filter shows (again to clear), and Ctrl-s sends the
  whole set — folders recursively — through the one authenticated connection, counting through
  the batch. An entry the destination already has is skipped and the queue carries on; the
  summary names what was passed over. Esc now clears marks before clearing the filter.
• Transfer: create directories with F7 (or Ctrl-f) on either side — a one-line input at
  the bottom of the focused pane. It creates exactly one directory in that pane's current
  directory, never adopts an existing name, and puts the new directory under the cursor.

Fixed

• Cancelling a transfer with Esc left the transfer screen stuck in its "transfer running"
  state, ignoring every key but Esc and Ctrl-c. It now reports the cancellation and returns
  to browsing.

Changed

• The F1 help overlay documents the transfer screen's keys and the active tmux mode.
• README, FAQ, and the docs site point at
  GitHub Discussions for questions and feature
  requests.

Install sshelf 0.12.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/max-rh/sshelf/releases/download/v0.12.0/sshelf-installer.sh | sh

Install prebuilt binaries via Homebrew

brew install max-rh/tap/sshelf

Download sshelf 0.12.0