Skip to content

0.12.0 — 2026-08-21

Choose a tag to compare

@github-actions github-actions released this 03 Sep 12:15

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 onceSpace 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

File Platform Checksum
sshelf-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
sshelf-x86_64-apple-darwin.tar.xz Intel macOS checksum
sshelf-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
sshelf-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum