xssh v0.5.1

专为 AI agent 打造的 SSH 客户端

已存主机、持久 shell、跨工具调用的可恢复任务。xssh 通过 CLI 或 MCP 返回结构化结果、处理提示,并使用已保存的凭据。

发给你的 agent
安装 xssh:阅读 https://xssh.io/llms.txt 并照做。
或 PowerShell
> irm https://xssh.io/install.ps1 | iex
或下载

Windows x64 · 远端: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]
agent 看到的输出就是这样。

不再卡在提示上

密码提示示例。OpenSSH 同样支持密钥、agent、PTY 和连接复用。

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

未配置提示处理时,这次调用会等待输入。

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]

提示被报告、被回答。shell 状态保留。

给人用的桌面管理器

主机、会话、端口转发、后台任务、审计日志和守护进程,一个窗口管理。查看会话不会打扰 agent。

xssh
守护进程
运行中 · 1 会话 · 0 转发
中文English

主机

4 台服务器。agent 按别名使用,密码存在系统凭据管理器里,agent 看不到。

搜索别名、地址、标签或备注添加主机
别名 / 备注地址认证跳板 / 标签系统
web1生产 Web 前端
deploy@192.0.2.10
密钥 id_ed25519
prodweb
Ubuntu 24.04.1 LTS最近连通 10-04 09:12:03
测试编辑凭据删除
dbPostgreSQL 16 主库
deploy@192.0.2.20
密码 · sudo
proddb
Debian GNU/Linux 12最近连通 10-04 09:10:41
测试编辑凭据删除
staging
ubuntu@198.51.100.7
密钥 staging.pem
staging
Ubuntu 22.04.5 LTS最近连通 10-03 18:22:15
测试编辑凭据删除
nas备份存储
admin@203.0.113.5:2222
agent / 默认密钥
经 web1backup
FreeBSD 14.1-RELEASE最近连通 10-02 21:04:56
测试编辑凭据删除

界面示意,数据为示例。应用支持中英文,在侧栏底部切换。

一条命令,一个精确结果

输出简洁、无颜色码,带退出码和下一步。

命令作用
xssh host list
已存服务器:备注、标签、系统、上次成功。
xssh exec H -- cmd
单台、多台或 @tag 并行。真实退出码。
xssh exec H --no-wait --id ID -- cmd
可恢复执行;用 operation status/read/wait/cancel 管理。
xssh mcp
5 个 stdio 结构化工具,与 CLI 共用 daemon。
xssh session run N -- cmd
跨调用保留 cwd、环境变量和程序的 shell。
xssh session send N …
回答提示,驱动 REPL、vim、top。
xssh job start H -- cmd
不怕超时和断线。
xssh file edit H PATH
精确原子替换,自动备份。
xssh cp SRC… DST
rsync 式:跳过未变文件,大文件续传。
xssh forward add H -L …
-L、-R、SOCKS5,由守护进程托管。
xssh status | diag | logs H
健康、诊断与下一步、日志。
xssh host trust H
主机密钥变了?由人确认。

状态与判断依据

JSON 区分已验证的完成与提示符、屏幕推断;文本回复以此结尾:

[xssh NAME STATE exit=CODE prompt=KIND]

密码留在你手里

agent 拿到能力,不拿凭据。

  • 密码存于系统钥匙串。
  • 由你在终端或对话框输入,不进对话。
  • sudo 自动从钥匙串填写。
  • {secret:NAME} 注入秘密,输出显示 ***。
  • 主机密钥变化绝不绕过。
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
→ 由你在对话框输入

安装

Windows x64。远端:任意 POSIX shell。

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