csshW

Cluster SSH tool for Windows inspired by csshX

¹²

Pre-requisites

• Any SSH client (Windows 10 and Windows 11 already include a built-in SSH server and client - docs)
• Default terminal application is set to Windows Console Host in the windows Terminal Startup Settings (Windows 11 only)

Overview

csshW will launch 1 daemon and N client windows (with N being the number of hosts to SSH onto).
Key-strokes performed while having the daemon console focussed will be sent to all clients simoultaneously and be replayed by them.
Focussing a client will cause any key-strokes to be sent to this client only.

Download/Installation

csshW is a portable application and is not installed.
To download the csshW application refer to the Releases 📦 page.

Usage

csshw.exe --help
Cluster SSH tool for Windows inspired by csshX

USAGE:
    csshw.exe [OPTIONS] [HOSTS]... [SUBCOMMAND]

ARGS:
    <HOSTS>...    Hosts to connect to

OPTIONS:
    -d, --debug                  Enable extensive logging
    -h, --help                   Print help information
    -u, --username <USERNAME>    Username used to connect to the hosts 
    -V, --version                Print version information

SUBCOMMANDS:
    client
    daemon
    help      Print this message or the help of the given subcommand(s)

Example: csshw.exe -u root hosta.dev hostb.dev hostc.dev

We recommend using the ssh_config for any configurations like default username etc.

Configuration

csshw-config.toml contains all relevant configurations and is located in the same directory as the executable. It is automatically created with default values if not present.

clusters

An array of clusters that can be used to alias a set of host names to a specific tag:

clusters = [
    { name = "dev", hosts = ["hosta.dev", "[email protected]", "hostc.dev"] }
]

Clusters may be nested, but be aware of recursive clusters which are not checked for.

client

A collection containing client relevant configuration

[client]
ssh_config_path = 'C:\Users\demo_user\.ssh\config'
program = 'ssh'
arguments = [
    '-XY',
    '{{USERNAME_AT_HOST}}',
]
username_host_placeholder = '{{USERNAME_AT_HOST}}'

ssh_config_path

The full qualified path where your ssh configuration can be found.

program

Which executable will be used to establish ssh connections.

arguments

Additional arguments specified to the chosen program.

username_host_placeholder

Placeholder string that indicates where the username@host string should be inserted in the program arguments.

daemon

A collection containing daemon relevant configuration

[daemon]
height = 200
aspect_ratio_adjustement = -1.0
console_color = 207

height

The height of the daemon console.

aspect_ratio_adjustment

Configures whether the available screen space should rather be used horizontally or vertically.

console_color

Configures background and foreground colors used by the daemon console. Available are all standard windows color combinations (windows docs):

FOREGROUND_BLUE:        1
FOREGROUND_GREEN:       2
FOREGROUND_RED:         4
FOREGROUND_INTENSITY:   8
BACKGROUND_BLUE:        16
BACKGROUND_GREEN:       32
BACKGROUND_RED:         64
BACKGROUND_INTENSITY:   128

e.g. white font on red background: 8+4+2+1+64+128 = 207

Contributing

csshW uses pre-commit githooks to enforce good code style.
Install them via git config --local core.hooksPath .githooks/.

Footnotes

1. The searchbar used to launch csshw in the demo clip is keypirinha. ↩

2. The tool to show key presses in the demo clip is carnac the magnificent. ↩