SSHells dzonder

Install SSHells with WinGet

winget install --id=dzonder.sshells -e

SSHells is a utility designed to facilitate shell selection on Windows after establishing an SSH connection. It allows users to choose between different shells seamlessly, enhancing the flexibility of their SSH sessions.

Key Features:

Shell Selection: Enables users to pick from various shells post-SSH connection, providing immediate access without manual configuration.
WinGet Integration: Easily install and manage SSHells using WinGet, ensuring a smooth setup process.
Configuration Flexibility: Customize default shells through an editable config.json file, offering tailored settings for individual preferences.

Audience & Benefit: Ideal for Windows users who frequently use SSH connections, SSHells offers the benefit of quick shell switching. This tool streamlines workflow by reducing manual steps, allowing users to focus on their tasks with ease and efficiency.

README

SSHells

Simple utility that can be used as a default OpenSSH shell that lets you pick the shell after establishing SSH connection.

animated

Setup

Windows

Install (execute in elevated PowerShell):

# Install using WinGet (Windows Package Manager).
winget install dzonder.sshells

# Set the default shell in OpenSSH.
# https://learn.microsoft.com/en-us/windows-server/administration/openssh/openssh_server_configuration#configuring-the-default-shell-for-openssh-in-windows
New-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShell -Value "$env:LOCALAPPDATA\Microsoft\WinGet\Links\sshells.exe" -PropertyType String -Force

Uninstall (execute in elevated PowerShell):

# Uninstall using WinGet (Windows Package Manager).
winget uninstall dzonder.sshells

# Restore cmd.exe as the default shell in OpenSSH.
Remove-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShell

Configuration (optional)

To change the default shells edit config.json:

# Edit the config.json using notepad.
notepad $env:ProgramData\dzonder\SSHells\config.json

See src/config.json for an example. Default configuration will be written upon first run of sshells.exe.