โ† All setup docs

Install the room agent with one prompt

The Recording Club ยท bundle v1.5.2 ยท any Mac, any user, no secrets in the download

A room Mac wired through an Apollo interface to a door in the cloud, the path a mode switch takes.

๐ŸŽฏ Put the room id and the code in, copy, paste into Claude Code on the room Mac.

Before you paste Claude Code signed in on that Mac ยท UAD Console installed ยท Apollo connected and powered ยท you are logged into that Mac's desktop in its own account. The admin password is optional: the agent holds its own no-sleep assertion, so an install without one still runs overnight.

  
Fill both fields, then copy. Plain text copy: rr-install-prompt-v1.5.2.md

What the prompt actually does

๐Ÿ“ฆ Verifies before it installs

Downloads rr-room-bundle-v1.5.2.tgz, checks it against the published sha256, and refuses to unpack a mismatch.

๐Ÿ”‘ Trades the code for the keys

The bundle carries no token and no secret. The installer posts the one-time code to the door over HTTPS and writes what comes back into ~/trc-room/env, mode 600.

๐Ÿค– Reads its own JSON and retries

install.sh --json reports every step as pass, fail or needs_human with the exact remedy. Claude fixes what it can and re-runs. The installer is idempotent.

๐ŸŽš๏ธ Derives the Play Live session

It reads the RehearsalRoom2026 DAW session, unmutes the channels the band hears live, writes RehearsalRoom2026_NODAW and registers it. A person is asked only when there is nothing to derive from.

โœ… Ends on evidence

The load-verb probe, the test counts, the LaunchAgent actually loaded, the room reading online at the door. Not a claim that the files were copied.

What it cannot do for you

StepWhy a human is neededWhat you do
preflight_cltCommand Line Tools can fall back to a GUI installer Click Install in the dialog, say so, it carries on
login_items_backgroundmacOS will not let a script grant background permission One toggle in Login Items & Extensions, it opens the pane for you
system_settingssudo needs a typed password Type it once. Everything admin runs in that one prompt
auto_loginFileVault blocks auto-login outright Turn FileVault off, or accept a human login after reboots
console_detectUAD Console is a licensed download Install it from uaudio.com first
live_presetOnly when the DAW session is missing, or every channel is already unmuted Usually nothing. The installer derives the Play Live session from the DAW session and registers it. If it asks, save the session in Console and run bash ~/trc-room/add-live-preset.sh <file>

Minting a code

๐Ÿ”‘ Greg, on his Mac

rr-enroll-code studio-c

  • Single use, expires in 24 hours
  • Stored hashed, never recoverable after minting
  • Send the code and the room id, nothing else

๐Ÿ” If a code is spent

Mint a new one. Reusing a spent code answers already_used and the installer stops rather than retrying.

๐Ÿงน Starting over

bash ~/trc-room/uninstall.sh --purge, get a fresh code, paste the prompt again. Nothing in the install is destructive.

The manual path

๐Ÿ”ง Runbook v1.5

Every step by hand, for a Mac with no Claude Code on it.

Open the runbook โ†’

๐Ÿ“ฆ Bundle v1.5.2

Public download, no secrets inside.

rr-room-bundle-v1.5.2.tgz ยท sha256

๐Ÿ“„ Staff guide v1.1

What the mode switch does and what members see.

Open the PDF โ†’