Prove it works
By the end of this page you have started a session from your phone, seen the box refuse what it should refuse, and watched it come back by itself after losing power. A recovery path you have not rehearsed is one you do not have.
Build a boxOn this page
Start a session from your phone #
- Open claude.ai/code or the Claude phone app, signed in as the box's account.
- Start a new session on
agentbox. - Ask it to add
web. It calls theadd_repotool; approve it.
The session now has a folder of its own with a worktree of web in it, on a branch named for the session.
Ask the session to run these #
Each line checks one part of the build. Ask for them one at a time.
| Ask the session to run | Expect |
|---|---|
node -v && pnpm -v && go version |
Three versions |
[ -n "$GH_TOKEN" ] && echo set |
set. Never ask it to print the token. |
gh api /installation/repositories --jq '.repositories[0].full_name' |
One of your repos |
curl -sS -m 5 https://example.com |
Blocked, or a permission prompt |
cat /etc/agent-broker/github-app.pem |
Permission denied |
cd web && pnpm install && pnpm check |
The repo's own checks pass |
What each line proves:
- The first, that sessions started at boot can find the toolchain.
- The second and third, that the session has a working, short-lived GitHub token for exactly the repos you chose.
- The fourth, that commands cannot reach sites off the allowed list.
- The fifth, that agents can use a token but cannot read the key that mints it.
- The last, that a real task in a real repo works end to end.
Two checks from outside #
Run this from your workstation. Use any other device's Tailscale name in place of your-laptop.
ssh agentbox-agent 'whoami; sudo -n true 2>&1 | head -1; nc -zv -w 3 your-laptop 22'
It must print agent, then a refusal from sudo, then fail to connect. The failure is the point: the box cannot open a connection to your other devices.
Check the daemon saw it #
While the session is open, look at the box's own view:
nucleated status
The session is listed under main with its repo and branch. If the box is connected to Watch, the same session is in your inbox.
Test the power-cut recovery #
Skip this section if the box has no UPS.
Can the box read the UPS? #
upsc ups && upsc ups battery.charge.low
Look for ups.status: OL (on line power), battery.charge and battery.runtime. The last line should print 40.
If upsc cannot connect, unplug and replug the UPS's USB cable, then restart the driver:
sudo systemctl restart nut-driver@ups.service nut-server.service
A full shutdown and restart #
sudo upsmon -c fsd
What should happen, with mains power still on:
- The box shuts down cleanly.
- About a minute after the shutdown starts, the UPS switches its outlets off.
- About a minute after that, it switches them back on.
- The box starts by itself, unlocks its disk from the TPM, rejoins Tailscale, and starts the agent server once the internet is back.
After about five minutes, check from your workstation:
ssh agentbox uptime && ssh agentbox-agent systemctl --user is-active agent-server@main.service nucleated.service
It should print a short uptime and active twice. Then start a session from your phone.
A real outage #
Do this once the battery has charged for 8 hours.
-
Watch the charge from the box:
Box watch -n 5 upsc ups battery.charge -
Pull the UPS's plug from the wall. The status changes from
OLtoOB, on battery. -
Either plug it back in before the charge reaches 40%, or let it run down and watch the whole cycle: shutdown at 40%, outlets off, then a full restart once you plug the UPS back in.
The time it takes to fall from 100% to 40% is your real runtime.
If the box is connected to Watch, this is also the moment to see it from the other side. While the box is off, Watch marks the machine stale and then down, and tells you once. When it comes back, Watch tells you that once too. Deadlines has the timings.
Make it a habit #
Every few months, pull the plug and watch the box come back, start a session from your phone, and restore one file from the backup if you set one up.
The box is built. Day to day is the page to keep.