专为 AI agent 打造的 SSH 客户端
已存主机、持久 shell、跨工具调用的可恢复任务。xssh 通过 CLI 或 MCP 返回结构化结果、处理提示,并使用已保存的凭据。
安装 xssh:阅读 https://xssh.io/llms.txt 并照做。
> irm https://xssh.io/install.ps1 | iexsession 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]
不再卡在提示上
密码提示示例。OpenSSH 同样支持密钥、agent、PTY 和连接复用。
$ ssh deploy@web1 'sudo apt-get upgrade' [sudo] password for deploy: … 120 s, no output …
未配置提示处理时,这次调用会等待输入。
$ 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。
主机
4 台服务器。agent 按别名使用,密码存在系统凭据管理器里,agent 看不到。
会话
1 个交互式会话,由 agent 通过 `xssh session` 打开。这里只读查看。
web1 · 空闲 12 秒
运行:bash
最近输入:sudo apt-get upgrade
w 空闲
web1 · 120×32 · 创建于 10-04 09:08:51
deploy@web1:~$ sudo apt-get upgrade Reading package lists... Done The following packages will be upgraded: nginx nginx-common Do you want to continue? [Y/n] y Setting up nginx (1.24.0-2ubuntu7.5) ... deploy@web1:~$ cd /srv/app deploy@web1:/srv/app$
只读查看:不会向会话发送任何输入,也不影响 agent 的读取进度。
审计日志
最近 7 条远程操作(最新在前),来自 audit.jsonl。点击一行查看完整命令。
界面示意,数据为示例。应用支持中英文,在侧栏底部切换。
一条命令,一个精确结果
输出简洁、无颜色码,带退出码和下一步。
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]
- done
[xssh w done exit=0]已结束,退出码真实。 - waiting
[xssh w waiting prompt=confirm]有提示,用 session send 回答。 - running
[xssh w running]仍在输出,再读或等待。 - quiet
[xssh w quiet]在运行,无输出。 - tui
[xssh w tui]全屏程序,回复即屏幕。 - disconnected
[xssh w disconnected]断开(exit 69),持久会话自动重连。
密码留在你手里
agent 拿到能力,不拿凭据。
- 密码存于系统钥匙串。
- 由你在终端或对话框输入,不进对话。
- sudo 自动从钥匙串填写。
- {secret:NAME} 注入秘密,输出显示 ***。
- 主机密钥变化绝不绕过。
$ 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。
告诉 agent
它自己装好 xssh 和 skill。
安装 xssh:阅读 https://xssh.io/llms.txt 并照做。或自己装
一行命令,或解压到任意位置。
> irm https://xssh.io/install.ps1 | iex录入密码
你输入一次,agent 只用别名。
> xssh host add web1 --host 10.0.0.5 --user deploy --ask-password
skill 支持 Claude Code · Codex · Gemini CLI · GitHub Copilot · Cursor · OpenCode · Windsurf · Amp · Qwen Code · Kiro · Trae · Roo Code · ~/.agents (Cline…)