Skip to content

stassh 1.0.0

Choose a tag to compare

@github-actions github-actions released this 05 Sep 15:57
· 24 commits to main since this release

stassh v1.0.0

First public release of stassh-rust: a portable, offline-first SSH workspace for organizing hosts, launching OpenSSH sessions, and
reusing common SSH workflows from a shared vault.

This release includes three frontends over the same Rust core:

  • stassh: command-line interface for scripting and direct workflow use
  • stassh-tui: terminal UI for browsing, searching, inspecting, editing, connecting, and running actions
  • stassh-gui: Tauri desktop app with host navigation, inspector/editor panes, embedded terminal tabs, action previews, and terminal
    layouts

Highlights

  • Portable JSON SSH vault stored locally, designed to be copied or synced with tools you already trust
  • OpenSSH-first execution: stassh generates commands/config and launches the system ssh
  • Folder and host inventory with stable UUIDs, tags, notes, search, jump chains, SSH options, and local/remote/dynamic forwards
  • Import/export support for useful subsets of OpenSSH config files, including nested Include files
  • Machine-local identity mapping by key fingerprint, keeping private key paths out of the portable vault
  • Optional encrypted secrets.json support for host-associated fallback secrets
  • Reusable Actions for workflows that combine SSH forwards, remote commands, local prep, and local tool launch
  • Example Actions for VNC workflows and sending a local file to a remote host with scp
  • Simulation mode for both TUI and GUI, useful for demos, screenshots, and visual testing without touching real SSH config
  • Linux .deb and .rpm packages for amd64

User-Facing Features

  • Browse SSH hosts by folder in the TUI or GUI
  • Search by host name, path, hostname, username, tags, or notes
  • Preview generated SSH commands before running them
  • Launch SSH sessions through the system OpenSSH client
  • Use jump hosts and SSH port forwards without hand-writing command lines every time
  • Run reusable Actions such as VNC-over-SSH or file sending
  • Manage local key mappings and local executable capabilities separately from the portable vault
  • Use GUI terminal tabs, layout tabs, broadcast input, per-terminal find, and visible exited-session indicators
  • Use tmux/byobu launch support from the TUI for multiple terminal sessions

Linux Packages

The attached Linux packages install:

/usr/bin/stassh
/usr/bin/stassh-tui
/usr/bin/stassh-gui

Available package formats:

- .deb for Debian/Ubuntu-style systems
- .rpm for RPM-based systems

## Notes

stassh does not replace OpenSSH or implement its own SSH transport. It uses the system ssh, so existing OpenSSH behavior, agents, known-
host handling, jump support, certificates, hardware keys, and authentication flows remain available.

## Known Limitations

- No automatic identity discovery from ~/.ssh or ssh-agent yet
- Action authoring is currently JSON-first; examples and HOWTO-Actions.md document the workflow
- The Send file to home example uses scp directly and does not automatically inherit complex stassh jump-chain or identity mappings unless
  adapted or backed by an existing OpenSSH config entry