Cluster SSH tool for Windows inspired by csshX

¹²

• Default terminal application is set to Windows Console Host in the windows Terminal Startup Settings (Windows 11 only)

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.

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

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

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

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

OPTIONS:
    -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.

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.

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.

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}}'

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

Which executable will be used to establish ssh connections.

Additional arguments specified to the chosen program.

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

A collection containing daemon relevant configuration

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

The height of the daemon console.

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

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

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