Install & update

Get packages from the Download page. What to do after install: Overview.

Xiaohe Client

1. Download page → Xiaohe Client.
2. macOS: open the .dmg, drag Xiaohe to Applications.
3. Linux: .deb (sudo dpkg -i …).
4. Windows: run the .exe installer.

No account needed to install. Pro unlock: license in the app (Settings → Authorization). Usage: Xiaohe Client.

Update: the app checks the public channel (Settings → Updates). That does not upgrade Agent — use xiaohe upgrade for Agent (owner soak: xiaohe upgrade --beta).

Xiaohe Agent

Supported: macOS Apple Silicon, Linux x86_64, Windows x86_64.

Download page → Xiaohe Agent → run the one-line install shown there:

• macOS / Linux: curl -fsSL <download>/xiaohe-agent/install.sh | bash
• Windows: powershell -ExecutionPolicy Bypass -c "irm <download>/xiaohe-agent/install.ps1 | iex"

Then:

xiaohe doctor    # health check
xiaohe           # terminal chat (optional)
xiaohe setup     # resume / reconfigure if needed

macOS may need right-click → Open the first time (Gatekeeper).

Update / remove:

xiaohe upgrade
xiaohe upgrade --beta
xiaohe version && xiaohe doctor
xiaohe uninstall   # remove

After install

Goal	Next
Terminal chat	Agent CLI → xiaohe
Browser / desktop on this machine	Overview path B or C (server start + pair + key)
HTTP API	Session API