Host

Host CLI (termee)

Binary from cmd/host-agent, installed as termee (preferred) or host-agent (legacy).

CommandPurpose
termee setupGuided or flagged config; writes profile; optional --start
termee pair <code>Redeem pairing code → save host_token
termee connect / startConnect to Relay (daemon by default; --foreground)
termee stopStop daemon for a profile
termee statusConfig, relay, running?, last error — tokens masked

Non-interactive setup

termee setup --name=home --relay=wss://staging.termee.ai/ws --code=ABC123 --start --yes

Config layout

~/.termee/                    # or $TERMEE_HOME
  hosts/<name>.json
  run/<name>.pid
  run/<name>.log
  run/<name>.last_error

JSON fields: server_url, host_name, host_token, allowed_programs, optional App Entries.

Legacy

host-agent -config path.json -connect
host-agent -config path.json -run uname

Upgrade / reinstall guide →