Install · about 10 minutes
Set up forgd
The hub runs on your Mac next to your agents. Your iPhone reaches it privately over Tailscale. Nothing is exposed to the internet.
- 1
Get the iPhone app
Join the TestFlight beta, then open forgd on your iPhone. iOS 18 or later.
Request beta access - 2
Run the hub on your Mac
Start the hub where your OpenRig daemon runs. It binds to 127.0.0.1:7420 and watches your rigs, seats and subagents.
$npx forgd hub - 3
Reach it over your tailnet
Tailscale terminates HTTPS on your tailnet and proxies to the hub on loopback, so the hub never listens publicly.
$tailscale serve --bg --https=8443 http://127.0.0.1:7420 - 4
Sign in on your phone
Use the same account you use on forgd.dev. Tailscale has to be connected on the phone.
- 5
Turn on push (optional)
Add an APNs key to the hub's .env and restart it. Cards then arrive as notifications you can answer from the lock screen.
$APNS_KEY_ID=… APNS_TEAM_ID=… APNS_KEY_FILE=~/.forgd/AuthKey.p8