Skip to main content

Agent CLI

xiaohe runs terminal agents, local checks, and the Session API service.

Install: Install & update. Client / Web UI paths: Overview.

Terminal chat​

xiaohe                 # default backend
xiaohe doctor
xiaohe workspace init  # project workspace (optional)

For Client / Web UI​

xiaohe server install
xiaohe server start
xiaohe server pair     # print xh_… key → paste in Settings → Connection

Then open Web UI (http://127.0.0.1:8110/ or xiaohe webui --open) or Client.

Checks: xiaohe server status · doctor · logs.

Manage keys later: xiaohe keys issue|list|revoke …. That key is for chat only — not Pro license / MCP token (Overview).

Model providers​

Needed before useful replies (CLI or UI):

xiaohe switch provider
xiaohe switch provider deepseek --key <API_KEY>
xiaohe switch provider kimi --model kimi-k2.6 --base-url <URL>
xiaohe switch provider claude

Manage presets (add/list/remove, store keys) with xiaohe provider …; keys stay in ~/.xiaohe/agent/switch-configs.json on that machine. In the UI: Settings → Assistant.

Other commands​

AreaCommands
Localstatus · version · doctor · setup · upgrade · uninstall · switch · completion
Serverinstall · start · stop · restart · status · doctor · logs · pair · uninstall

Use these lifecycle commands day to day — not hidden foreground helpers (server api / worker / …).