sudoterm CLI

The sudoterm binary is your control surface for the daemon. It wraps systemctl for lifecycle commands, talks to the registry for subdomain changes, and includes a health-check (doctor).

Commands

sudoterm start
sudoterm stop
sudoterm restart
sudoterm status

sudoterm logs                       # journalctl tail -f
sudoterm logs --since "1h ago"
sudoterm logs --lines 500 --no-follow

sudoterm config
sudoterm config get <key>
sudoterm config set <key> <value>
sudoterm config path

sudoterm subdomain change <new>     # re-register with api.sudoterm.com
sudoterm password reset             # print reset instructions

sudoterm doctor                     # 11 health checks
sudoterm update                     # re-run installer
sudoterm uninstall                  # remove sudoterm
sudoterm uninstall --purge          # also delete ~/.sudoterm

sudoterm version | sudoterm help

Doctor

$ sudoterm doctor
sudoterm doctor
────────────────────────────────────────────────
  ✓ ok node ≥22             v22.22.2
  ✓ ok tmux                 /usr/bin/tmux
  ✓ ok cloudflared          /usr/local/bin/cloudflared
  ✓ ok git                  /usr/bin/git
  ✓ ok curl                 /usr/bin/curl
  ✓ ok ~/.sudoterm          /home/user/.sudoterm
  ✓ ok config.json          /home/user/.sudoterm/config.json
  ✓ ok data.db              /home/user/.sudoterm/data.db
  ✓ ok tunnel.json          /home/user/.sudoterm/tunnel.json
  ✓ ok sudoterm.service     installed
  ✓ ok daemon /health       http://127.0.0.1:7681

✓ all checks passed

Exit code: 0 (all green), 1 (any fail), 2 (warnings only).