CLI companion

Use SSH connections from scripts or automations — no login dialog needed.

How does it work?

NeoSSHWinManager-cli.exe is a separate console app that communicates with the running main app. Enable CLI access for a connection and get an access key — use it from any script to connect instantly.

Requirements

  • The main app is running and you are signed in.
  • CLI access is enabled for the connection.
  • You have the access key (visible in the connection editor).

Examples

Interactive SSH session

Recommended: pass the access key via stdin so it never shows up in the process list (Task Manager, tasklist) for other local processes.

echo <access_key> | NeoSSHWinManager-cli.exe --connect-cli -

Alternatively, pass it directly as an argument (the key is then visible to other local processes):

NeoSSHWinManager-cli.exe --connect-cli "<access_key>"

Run a single command

echo <access_key> | NeoSSHWinManager-cli.exe --connect-cli - --exec "uname -a"
echo <access_key> | NeoSSHWinManager-cli.exe --connect-cli - --exec "hostname"
echo <access_key> | NeoSSHWinManager-cli.exe --connect-cli - --exec "cd /var/www && ls -la"

Options

Option Description
--connect-cli <key>Access key for the connection. Pass - instead of the key to read it from stdin instead (recommended, see the security note).
-connectssh <key>Alias (alternative spelling).
--exec "<cmd>"Optional: run a command instead of an interactive shell.

Exit codes

  • 0 — Success.
  • 1 — Error (app not running, not signed in, invalid key).
  • 2 — Missing arguments.
  • With --exec, the remote command's exit code is passed straight through — the return value can therefore also fall outside 0/1/2.
Security note The access key is only transferred locally — never over the network. If passed as a command-line argument, it is visible to other processes on the same machine (e.g. via Task Manager or tasklist). Pass it via --connect-cli - and stdin instead of writing it in plain text into scripts or repositories — or read it from a local .env file or the Credential Manager and pipe it in.