The Mac Studio is the only machine for builds, tests, stands and agents (AGENTS.md). The MacBook controls it remotely. This page records how to reach it, what it should measure, and how to recognise and fix the throttled state found on 2026-10-26.
Mac15,14): 24 performance + 8 efficiency cores, 512 GB RAM,
3.6 TB SSD, FileVault ON. Repo at /Users/zigota/xln, user zigota.ssh mac-studio. This is ProxyJump studio-relay
(xln.finance) to 127.0.0.1:22222; see ~/.ssh/macstudio.conf.com.egor.mac-studio-tunnel
(RunAtLoad + KeepAlive, runs as zigota). It comes back after a reboot without a GUI login.ssh -f -N -L 5901:127.0.0.1:5900 mac-studio && open vnc://127.0.0.1:5901.banner exchange timeouts). KeepAlive restores it; just wait./etc/sudoers.d/xln-diag):
sudo -n /usr/bin/powermetrics, /usr/sbin/spindump, /usr/bin/taskinfo.
Nothing else runs as root without the owner typing the password.xln.finance) does not run on the Studio. User services on the
Studio (hermes and openclaw gateways, chatgpt.roster.* with a zrok share, com.xln.whisper)
are user LaunchAgents: after a reboot they start only when someone logs into the GUI
(RustDesk).Benchmark, single Bun process (bun -e) running a 1e8-iteration modulo loop:
bun -e 'let t=performance.now();let x=0;for(let i=0;i<1e8;i++)x=(x+i*7)%1000003;console.log(Math.round(performance.now()-t))'
| Machine / state | 1 copy | 16 copies (each) | 24 copies (each) | taskpolicy -c background |
|---|---|---|---|---|
| Studio, healthy (after reboot 2026-10-26) | ~350 ms | ~360 ms | ~365 ms | ~800 ms |
| Studio, throttled (before) | ~1030 ms | ~2400 ms | ~3300 ms | ~1040 ms (same as default) |
| MacBook M1 Max | ~550 ms | n/a | n/a | ~1160 ms |
E2E on a healthy Studio (bun run test:e2e:full, 16 lanes, MM x4, reset x4):
c25cdcf6d (2026-10-27): 157/157 in 516 s.Symptoms, all measured on 2026-10-26 after 12 days of uptime:
taskpolicy -c background clamp.sudo -n powermetrics -n 1 -i 2000 --samplers cpu_power under load showed:
lowpowermode was 0.Ruled out:
taskinfo showed default roles), offline cores and the recommended-core mask.Fix: a FileVault-preserving reboot that the owner starts and authenticates:
ssh -t mac-studio 'sudo fdesetup authrestart'
It asks for the sudo password, then the FileVault user name (zigota, not root) and
that user’s password. SSH returns about 1-2 minutes later.
After the reboot, log zigota into the GUI (RustDesk or Jump Desktop) before any browser E2E.
Without a GUI session there is no display/notification service and Chrome for Testing crashes
mid-test (NSNotificationCenter connection invalid, CVDisplayLinkCreateWithCGDisplay failed,
then signal 10 BUS_ADRALN). User services also start only after this login, including the
Red Shield VPN app: without it Codex fails with workspace routing discovery failed, OpenRouter
returns 403 Access denied by security policy and Z.ai times out, so every quorum leg is INCOMPLETE.
Before rebooting:
RunAtLoad would start at login.com.xln.* job agents from earlier controllers were moved to
~/Library/LaunchAgents.disabled-20261027 on 2026-10-26.com.xln.studio-native-guard, com.xln.studio-prod-rescue-guard and
com.xln.whisper remain./tmp, each 6-45 GB. A reboot clears them.zai-coding-cn, Gemini/Kimi via OpenRouter) and
the 3-AI quorum runner live in ~/agent-jobs/claude-ext-20261026/ (quorum.sh, ask.ts,
smoke-legs.sh). Smoke-test every leg on a known answer before trusting a quorum.Set up a new control machine:
~/.ssh/macstudio_ed25519,
~/.ssh/macstudio.conf, ~/.ssh/macstudio_known_hosts, and the Include line for
macstudio.conf in ~/.ssh/config. Check with ssh mac-studio 'cd ~/xln && git log -1 --oneline'.git push from the
control Mac: the pre-push hook runs the full verify in the pushing checkout.AGENTS.md or todo.md.Remote shell:
PATH and a raised descriptor limit:
export PATH=$HOME/.bun/bin:$HOME/.cargo/bin:$HOME/.foundry/bin:/opt/homebrew/bin:$PATH; ulimit -n 65536.nohup script.sh >/dev/null 2>&1 &, the script appends
DONE to its summary, the control Mac waits with
until ssh mac-studio 'grep -q DONE file'; do sleep 30; done.~/agent-jobs/<job>-<date>/, never in /tmp.Verify a change without touching ~/xln:
git -C ~/xln worktree add --detach ~/xln-<job> <sha>, then apply the patch there.~/xln/jurisdictions/lib/forge-std to the
same path (as lib/forge-std, not into lib/ itself), and run bun install --frozen-lockfile
in the root, frontend/ and ui/.(cd rscore && cargo build -q --release -p xln-rscore-process --bin xlnrs).bun run contracts:sync after any Solidity change and commit the regenerated artifacts,
then bun run check (about 30 s), bun run test:contracts:full (about 50 s),
(cd rscore && cargo test -q --workspace), each folder under core/__tests__/ with
bun test --timeout 180000 (about 10 min in total), and bun test ui/src tests/frontend.bun run check runs gates in parallel and stops at the first failure; the later FAIL lines
in its log are gates it killed, so read the first one.check:folder-width); put a new test in a folder
with room.Land:
wip: subject.cd ~/xln && git merge --ff-only <sha> && git push origin main. The hook takes about ten
minutes and prints VERIFY_PASS:<sha>. Run it detached.git fetch origin && git merge --ff-only origin/main. git pull refuses
when any tracked file is modified.Looking at a page without a dev server: Playwright’s headless Chromium is installed under
~/Library/Caches/ms-playwright/; a ten-line script that opens a file:// page and saves
screenshots is enough to check layout in both colour schemes.