Skip to content
azazarPublic

About

A fast, keyboard-driven SSH launcher built with Rust and Ratatui. Search hosts from SSH config, shell history, and Midnight Commander bookmarks; connect with SSH, Mosh, Zellij, or custom commands. Includes per-host profiles, configurable shortcuts, and remote setup recipes.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Repository files navigation

Shui (Shell UI)

Your remotes, one terminal menu.

Find a machine, choose how to connect, and press Enter. Shui brings your SSH hosts, recent connections, remote file browser, and session launcher into one searchable list. Each host can use its own launch profile, and new machines can run a setup recipe before the first connection.

Shui showing a different launch profile for each remote

Type to fuzzy-search · ↑↓ to select · ←→ to choose a profile · Enter to connect

Install · User guide · Configuration · Setup recipes

What you can do

Choose Shortcut Open
SSH Alt+S Your usual remote shell, using existing SSH settings
Dropbear Alt+D A lightweight SSH session using dbclient
PuTTY Alt+P A PuTTY SSH window on Windows
Plink Alt+L A PuTTY SSH connection in the current Windows terminal
Mosh Alt+M A Mosh session for connections that need to survive network changes
MC Alt+C Midnight Commander browsing the remote filesystem
Bash Alt+B An interactive remote Bash login shell
Zellij Alt+Z An existing remote session, or a new session if none exists
Tmux Alt+T Attach to the remote main session, creating it if needed
SFTP Alt+F An interactive file-transfer session
Monitor Alt+H Remote btop with your normal configuration
Tunnel / SOCKS Ctrl+Alt+L / Ctrl+Alt+D A localhost port forward or SOCKS proxy, with editable settings
Your own profile Configurable Any command or remote script defined in YAML

Hosts come from SSH config, Bash history, and Midnight Commander bookmarks. Shui remembers each host's launch profile. Setup recipes can install container engines, configure SSH keys, copy terminal definitions, and deploy dotfiles, installing needed dependencies and starting relevant services. Connection profiles only launch tools: install their prerequisites separately.

Installation

Linux and macOS (including WSL):

curl -fsSL https://azazar.github.io/shui/scripts/install.sh | sh

Windows (PowerShell):

irm https://azazar.github.io/shui/scripts/install.ps1 | iex

Both installers detect your platform, verify the download, and install to ~/.local/bin. Add that directory to your PATH if needed. Set SHUI_INSTALL_DIR to use another directory. Re-run the command to update.

Windows runs connection clients directly and uses built-in PowerShell for setup; Git and a POSIX shell are not required. Install your preferred SSH client if needed. macOS binaries are unsigned.

Manual downloads: v0.1.0-rc.13 · Build from source

Get started

Run shui, or shui prod to start with a search filter. Type to search, use ↑↓ to select a host and ←→ to choose a profile, then press Enter.

  • Alt+Enter connects and returns to the menu afterward.
  • Ctrl+Enter adjusts a single connection.
  • F4 configures a remote; Shift+F4 adds one.
  • F9 edits configuration; F1 opens offline help.

Hold Alt, Shift, or Ctrl to reveal the relevant shortcuts.

Customize

Edit $XDG_CONFIG_HOME/shui.yml (default ~/.config/shui.yml) to change profiles, setup recipes, and keybindings. See defaults and optional examples. Validate changes with shui --check-config.

User guide · Configuration · Keybindings · Setup recipes · Development

License

GPL-3.0-only.

About

A fast, keyboard-driven SSH launcher built with Rust and Ratatui. Search hosts from SSH config, shell history, and Midnight Commander bookmarks; connect with SSH, Mosh, Zellij, or custom commands. Includes per-host profiles, configurable shortcuts, and remote setup recipes.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages