xssh v0.5.1

An SSH client built for AI agents

Saved hosts, persistent shells and recoverable commands across tool calls. xssh reports structured results, handles prompts and uses stored credentials through CLI or MCP.

Tell your agent
Install xssh: read https://xssh.io/llms.txt and follow it.
Or PowerShell
> irm https://xssh.io/install.ps1 | iex
Or download

Windows x64 · Remote: Linux, macOS, FreeBSD · MIT

wdone

session w · web1

$ xssh session run w -- 'sudo apt-get upgrade'
Do you want to continue? [Y/n]
[xssh w waiting prompt=confirm]
$ xssh session send w y --enter
Setting up nginx (1.24.0-2ubuntu7.5) …
[xssh w done exit=0]
$ xssh session run w -- pwd
/srv/app
[xssh w done exit=0]
Output as the agent sees it.

No more hanging on prompts

A password-prompt example. OpenSSH also supports keys, agents, PTYs and connection reuse.

ssh
$ ssh deploy@web1 'sudo apt-get upgrade'
[sudo] password for deploy:
… 120 s, no output …

Without a prompt handler, this call waits for input.

xssh
$ xssh session run w -- 'sudo apt-get upgrade'
Do you want to continue? [Y/n]
[xssh w waiting prompt=confirm]
$ xssh session send w y --enter
[xssh w done exit=0]

The prompt is reported and answered. The shell keeps its state.

A desktop manager for the human

Hosts, sessions, forwards, jobs, audit log and daemon in one window. Watching never disturbs the agent.

xssh
Daemon
Running · 1 sess · 0 fwd
中文English

Hosts

4 servers. Agents use aliases; passwords stay in the system keyring.

Search alias, address, tag or noteAdd host
Alias / noteAddressAuthJump / tagsSystem
web1Web front end
deploy@192.0.2.10
key id_ed25519
prodweb
Ubuntu 24.04.1 LTSlast ok 10-04 09:12:03
TestEditSecretsDelete
dbPostgres primary
deploy@192.0.2.20
password · sudo
proddb
Debian GNU/Linux 12last ok 10-04 09:10:41
TestEditSecretsDelete
staging
ubuntu@198.51.100.7
key staging.pem
staging
Ubuntu 22.04.5 LTSlast ok 10-03 18:22:15
TestEditSecretsDelete
nasBackup storage
admin@203.0.113.5:2222
agent / default
via web1backup
FreeBSD 14.1-RELEASElast ok 10-02 21:04:56
TestEditSecretsDelete

Interface preview with sample data. The app speaks English and Chinese; switch at the bottom of the sidebar.

One command, one exact result

Terse, ANSI-free output with exit codes and next steps.

CommandWhat it does
xssh host list
Saved servers: notes, tags, OS, last success.
xssh exec H -- cmd
One host, many, or @tag in parallel. Real exit codes.
xssh exec H --no-wait --id ID -- cmd
Recoverable execution; operation status/read/wait/cancel.
xssh mcp
Five typed tools over stdio, sharing the CLI daemon.
xssh session run N -- cmd
A shell that keeps cwd, env and programs across calls.
xssh session send N …
Answer prompts. Drive REPLs, vim, top.
xssh job start H -- cmd
Outlives timeouts and disconnects.
xssh file edit H PATH
Exact, atomic replace with backup.
xssh cp SRC… DST
rsync-like. Skips unchanged files, resumes large ones.
xssh forward add H -L …
-L, -R, SOCKS5, held by the daemon.
xssh status | diag | logs H
Health, diagnosis with the next step, logs.
xssh host trust H
Host key changed? A human confirms.

Session state with evidence

JSON distinguishes verified completion from prompt and screen heuristics. Text replies end with:

[xssh NAME STATE exit=CODE prompt=KIND]

Secrets stay with you

Agents get capabilities, not credentials.

  • Passwords live in the OS keyring.
  • You type them in a terminal or dialog, never in chat.
  • sudo is filled from the keyring.
  • {secret:NAME} injects secrets; output shows ***.
  • Changed host keys are never bypassed.
xssh
$ xssh file edit db /srv/app/.env --old 'DB_PASS=old' --new 'DB_PASS={secret:dbpw}' --secrets
edited /srv/app/.env (1 replacement)
12  DB_PASS=***
$ xssh host set-password db
→ typed by you in a dialog

Install

Windows x64. Remote: any POSIX shell.

Skill for Claude Code · Codex · Gemini CLI · GitHub Copilot · Cursor · OpenCode · Windsurf · Amp · Qwen Code · Kiro · Trae · Roo Code · ~/.agents (Cline…)