sshocked

sshocked – Shelling into servers and containers with lightning speed.

A .NET console application that provides a fast, interactive terminal UI for managing and connecting to SSH servers and containers. Organize hosts into groups, import from your OpenSSH config, and launch SSH sessions — all from a single, keyboard-driven interface.

• Server Management — Add, edit, and delete SSH hosts with aliases, addresses, ports, and authentication methods
• Group Organization — Group servers by project, environment, or any category; connect to all servers in a group at once
• SSH Config Import — Parse your existing ~/.ssh/config and import hosts automatically
• Multiple Auth Methods — SSH key (with optional identity file), password, SSH agent, or custom SSH options
• Interactive TUI — Keyboard-driven terminal UI with sub-menu navigation and a server overview table
• Native AOT — Published as a native binary for fast startup and zero runtime dependencies

• .NET 10 SDK (for development/building from source)
• OpenSSH Client (for SSH connections)

Linux & macOS:

curl -fsSL https://github.com/ms-sk/sshocked/releases/latest/download/install.sh | sudo sh

Windows (PowerShell as Administrator):

irm https://github.com/ms-sk/sshocked/releases/latest/download/install.ps1 | iex

This automatically detects your OS and architecture, downloads the correct binary, and installs it to /usr/local/bin/ssk (Linux/macOS) or %ProgramFiles%\sshocked\ssk.exe (Windows, added to PATH).

Download the .deb for your architecture from the Releases page and install:

sudo apt install ./sshocked-linux-x64.deb
# or
sudo dpkg -i sshocked-linux-x64.deb

1. Download the latest archive for your platform from the Releases page
2. Extract the binary and add it to your PATH

# Clone the repository
git clone https://github.com/ms-sk/sshocked.git
cd sshocked

# Restore dependencies
dotnet restore

# Build
dotnet build --configuration Release

# Run
dotnet run --project src/Sshocked/Sshocked.csproj

dotnet publish src/Sshocked/Sshocked.csproj \
  -c Release \
  -r <RID> \
  --self-contained true \
  -o ./publish

Replace <RID> with your platform runtime identifier (e.g., linux-x64, win-x64, osx-x64, linux-arm64).

Launch the application:

sshocked
# or the shorter alias:
ssk

sshocked (or ssk) supports command-line arguments for direct SSH connections and non-interactive usage:

Examples:

# Direct connection to a server
ssk prod-db-01

# Connect to all servers in a group
ssk production

# Non-interactive listing (great for scripting)
ssk --list | grep prod

When launched without arguments, the main menu displays a table of all configured servers grouped by category. Navigate using the keyboard:

• Arrow keys — Move selection
• Enter — Select a server or action
• [C] Connect - Connect to a server / docker container
• [G] Connect Group - Connect to a server / docker
• [X] Run command - Run command on the groups
• [S] Servers - CRUD Servers
• [R] Groups - CRUD Groups
• [B] Back — Return to the previous menu
• [E] Exit — Exit the application

See SKILLS.md for the full command reference and details on adding new commands.

Configuration is stored in a local JSON file:

The file is auto-created on first run. Logs are written to logs/sshocked.log in the same directory (rotated at 5 MB, up to 3 backups).

Sshocked.slnx              -- Solution file (.slnx format)
src/Sshocked/
├── Program.cs             -- Entry point with DI bootstrapping
├── Sshocked.csproj        -- Project file (net10.0, AOT-ready)
├── Models/                -- Domain models (AppConfig, ServerHost, ServerGroup)
├── Interfaces/            -- Core interfaces (IConfigRepository, ISshConfigImporter, IAppRunner, ...)
└── Services/              -- Implementations (JsonConfigRepository, AppRunner, ...)

This project is licensed under the GNU General Public License v3.0 — see the LICENSE file for details.

This project uses the following third-party libraries. See the NOTICE file for full attribution and license details.