easy-ssh-tui

A simple, fast terminal application built with Rust and Ratatui to easily manage and view your SSH keys.

Features

• View SSH Keys: Displays a list of your SSH keys found in the ~/.ssh directory.
• Key Details: Automatically shows the associated public and private key contents for the selected SSH key.
• Copy Public Key: Quickly copy the selected public key to your clipboard with a single keystroke.
• SSH Key Generation: Create new ed25519 SSH keys directly from the UI.
• PEM File Importer: Securely import existing .pem files from your filesystem with automatic permission handling (chmod 600) and passphrase support via ssh-add.
• Terminal UI: Lightweight and responsive terminal interface.

Release Notes

Please see the CHANGELOG.md for the latest release notes and history.

Requirements

• Rust (Cargo)
• An existing ~/.ssh directory with SSH keys.

Installation

Clone the repository and build the project using Cargo:

git clone https://github.com/yourusername/easy-ssh-tui.git
cd easy-ssh-tui

If you just want to install and use it immediately, you can run the provided release script (Mac/Linux):

./release.sh

Alternatively, you can build and install it manually via Cargo:

cargo build --release
cargo install --path .

Usage

Run the application from your terminal:

easy-ssh

Or run it directly using cargo if you are in the project directory:

cargo run

Keybindings

• Up or k: Move selection up
• Down or j: Move selection down
• n: Open the prompt to create a new SSH key
• i: Open the file browser to import an existing .pem file
• c: Copy the selected public key to the clipboard
• q or Esc: Quit the application

Dependencies

• ratatui: Terminal UI library
• crossterm: Cross-platform terminal manipulation
• arboard: Cross-platform clipboard support
• dirs: System directory paths