SSHPILOT(1)

NAME
sshpilot - SSH connection manager with integrated terminal

SYNOPSIS
sshpilot [OPTIONS] [SSH_DESTINATION...]

DESCRIPTION
sshPilot is a GTK4/libadwaita SSH connection manager with an integrated VTE terminal, port forwarding and tunnelling, and an SFTP file manager. It stores connection profiles, integrates with the system keyring for credentials, and drives the native OpenSSH client for every connection.

When a destination is given on the command line, sshPilot opens it in a terminal tab using the same forms as OpenSSH (Host alias, user@host, and ssh options such as -p, -i, -J). If the destination cannot be parsed, sshPilot prints an error to standard error, exits with status 255, and does not start a connection or open a tab (like ssh(1)). If the resolved hostname/IP (or username for that host) is not already present in the SSH config, a successful connect offers to save a new connection.

OPTIONS

--version
    Print the SSH Pilot version and exit.

--verbose
    Verbose debug logging (overrides config). There is no -v short form, so OpenSSH's own -v passes straight through to the connection.

--quiet
    Only show warnings and errors (overrides config). Like --verbose, there is no -q short form, so OpenSSH's own -q passes straight through.

--isolated
    Use an isolated SSH configuration.

--sftp
    Open the destination in the file manager (SFTP) instead of a terminal tab.

--log-gtk-warnings
    Also capture lower-severity GTK/GLib info and debug messages.

--fatal-warnings
    Abort on the first GTK/GLib warning or critical, writing a full backtrace to crash.log.

--diagnostics
    Shorthand for --verbose --log-gtk-warnings. Recommended when filing a bug report.

SSH DESTINATION
After sshPilot options, remaining arguments are treated like an ssh command line. A leading ssh is optional and prepended when absent, so sshpilot -J bastion user@host and sshpilot ssh -J bastion user@host are equivalent. Other remote tools (scp, sftp, rsync, ssh-copy-id) are not wrapped and are rejected. Examples:

    sshpilot web
    sshpilot root@example.com
    sshpilot -p 2222 user@host
    sshpilot -i ~/.ssh/id_ed25519 user@host
    sshpilot -p 2222 -i ~/.ssh/id_ed25519 -J bastion user@host
    sshpilot ssh -J bastion user@host
    sshpilot --sftp user@host

A bare Host alias that already exists in ~/.ssh/config opens that saved connection. Otherwise the argv is parsed into connection fields (via the command converter) and run with OpenSSH in a new tab. Invalid destinations (for example scp arguments) fail on the command line without opening the app session.

FILES

~/.ssh/config
    The OpenSSH client configuration, which sshPilot treats as the source of truth for per-host settings.

SEE ALSO
ssh(1), ssh_config(5)

AUTHOR
mFat <newmfat@gmail.com>