Support & usage
Everything about running the client. To point an AI assistant at the relay, see connecting an AI →
Tokens come from your administrator. Enrollment and access tokens are
issued in the admin console — if you need one, or a machine's access changed, contact your administrator.
Installing the client
A single self-contained binary — no runtime is installed on the host. Run the one-liner (it asks for your enrollment token):
Linux / macOS
curl -fsSL https://hpusa.mcp.darky.cc/install.sh | bash
Windows (PowerShell)
irm https://hpusa.mcp.darky.cc/install.ps1 | iex
- Update: re-run the same command — it detects the install and offers to update (config kept).
- Uninstall: Linux
curl -fsSL https://hpusa.mcp.darky.cc/install.sh | bash -s -- --uninstall· Windows$env:RELAY_UNINSTALL=1; irm https://hpusa.mcp.darky.cc/install.ps1 | iex - Run at boot: add
--service(Linux) or set$env:RELAY_SERVICE=1(Windows).
Portable clients (temporary, shell-only)
If your admin emails you a portable token, you can turn any host into a temporary target for your AI — handy for a one-off on your laptop or a box you don't want to permanently enroll.
- Download the agent for your OS from the links in the email (or under
https://hpusa.mcp.darky.cc/agent/dl/…). - Enroll with your token, giving the host a name you'll use with the AI, then run it:
./relay-agent enroll --server https://hpusa.mcp.darky.cc --token <your-token> --name "my-laptop" ./relay-agent run
- You'll get an email to confirm (or decline) the client; until you confirm, the AI can't use it.
- Ask your AI naturally, e.g. "on my-laptop, show the disk usage". Portable clients allow shell commands only.
- It's temporary: when you stop it (Ctrl-C) it's removed automatically and you get a note by email — and if it goes silent for 10 minutes it's cleaned up too. The token stays reusable; your AI can also end the connection itself.
If a token is ever exposed, use the "delete this token" link in your email or ask your admin.
Talking to the AI
Ask in plain language and name the host, e.g. "using the relay, check the logs on web-server-1". What the AI may do on each machine is set by your administrator.
Still stuck? Get in touch →