Reference

Agent CLI & tray

Commands, flags and the tray menu.

Commands

helm-agent                 # run; shows a pairing QR if no phone is paired yet
helm-agent --pair          # always show a pairing QR at start
helm-agent devices         # list paired devices and exit
helm-agent revoke <id>     # remove a paired device and exit
helm-agent check-update    # check GitHub Releases for a newer signed build

While it runs: p + Enter shows a fresh QR, q + Enter or Ctrl+C quits.

Flags

Flag	Meaning
`--data-dir <path>`	Data folder (default `%APPDATA%\Helm`)
`--port <n>`	TCP port (default 47820; a free one is used if busy)
`--no-mdns`	Don’t announce the PC on the network
`--no-tray`	Console only, no tray icon
`--background`	No console; logs go to `agent.log`

Tray menu

Show pairing QR · Paired devices · Start with Windows · Check for updates · Quit Helm.

Updates

The agent checks GitHub Releases. If there is a newer version it asks first, then verifies the download’s size, SHA-256 and Ed25519 signature. It never installs anything by itself.