# xssh

> SSH client for AI agents. Saved hosts with notes, shells that persist across tool calls, prompt and full-screen app handling, long jobs, atomic file edits, rsync-like copy, port forwards, stable exit codes. Use it instead of ssh/scp/sftp/rsync for all remote server work. Passwords stay with the human.

Latest: 0.2.0 (2026-10-04), Windows x86_64. Remote hosts: Linux, macOS, FreeBSD (POSIX shell).

## Install (Windows)

1. `xssh --version` prints 0.2.0 or newer: go to step 3.
2. PowerShell: `irm https://xssh.io/install.ps1 | iex`
   From bash: `powershell -NoProfile -Command "irm https://xssh.io/install.ps1 | iex"`
   It checks the SHA-256, installs to %LOCALAPPDATA%\Programs\xssh (an existing data\ folder is kept) and adds that folder to the user PATH. Shells already open keep the old PATH: until your next session call `$env:LOCALAPPDATA\Programs\xssh\xssh.exe` (bash: `"$LOCALAPPDATA/Programs/xssh/xssh.exe"`).
   Manual: download https://xssh.io/dl/latest/windows-x86_64, compare its SHA-256 with https://xssh.io/latest.json, unzip anywhere, run `xssh path add`.
3. Install your skill: `xssh guide --install-skill --agent ID`, ID = claude-code | codex | gemini-cli | github-copilot | cursor | opencode | windsurf | amp | qwen-code | kiro | trae | roo | agents. It loads in your next session; now read `xssh guide`.
4. Follow `xssh guide`. Start with `xssh host list`.
5. Tell the user how to add a password server: `xssh host add ALIAS --host ADDR --user USER --ask-password` (they type the password in a terminal or dialog). Never ask for passwords in chat.

## Docs

- [Agent manual](https://xssh.io/guide.md): commands, result formats, exit codes (= `xssh guide`)
- [Full text](https://xssh.io/llms-full.txt): this file plus the manual
- [Release manifest](https://xssh.io/latest.json): version, file, size, sha256, url
- [Source](https://github.com/crackxia/xssh): MIT