Ethics of AI

Docs AgentRoom

Install AgentRoom and pair your Vision Pro

Install the AgentRoom Mac app, join the Vision Pro beta on TestFlight, register a folder, and connect the headset over your local network.

Install guide

The Mac app is a public download, and the Vision Pro app is in open beta on TestFlight. This page covers what you need, how to install both, and how to get from a fresh install to a first agent turn.

Read trust and safety before you point AgentRoom at a repository you did not write.

What you need

Requirement
MacApple Silicon Mac with macOS 14 or later, awake, on the same network as the headset
HeadsetApple Vision Pro running visionOS 26
NetworkBoth devices on the same local network
AgentAt least one coding agent configured. Claude Code is the quickest, because it uses the claude login already on that Mac

There is no account to create with us and nothing to upload. The Mac does the work.

Join the beta

The visionOS client is distributed through TestFlight:

Join the AgentRoom beta on TestFlight

Open that link on the Vision Pro, or on an iPhone signed into the same Apple Account, and TestFlight will install the build. You will need the TestFlight app, which is free from the App Store.

Install the Mac app

The Mac app comes from the latest AgentRoom release, not the App Store, because it supervises a local server and stores credentials in your Keychain. Each release carries AgentRoom-<version>-arm64.dmg and SHA256SUMS.txt. It runs on Apple Silicon only.

Download both files to the same folder and check the DMG before you open it. --ignore-missing skips the release files you did not download:

shasum -a 256 -c --ignore-missing SHA256SUMS.txt

Open the DMG, drag AgentRoom.app to Applications and launch it. The app is signed and notarised by Apple. It bundles its own Node.js runtime and the backend, so the backend needs nothing else installed, though you still need at least one agent configured. The app checks for updates once a day and asks before it installs one.

The Mac app and backend are MIT licensed. The Vision Pro app is not, and comes through TestFlight.

Set up the Mac

The macOS app is the operator console. Everything on this list happens there.

  1. Configure an agent. Pick one from the agents AgentRoom drives. Claude Code needs the least setup: if you already use it on that Mac, AgentRoom can use that login. Codex needs a path to its executable. Cursor needs a web sign-in through the bundled SDK.
  2. Create a bearer token. The backend binds to your local network so the headset can reach it, which means a token is not optional in practice. Create one in the Mac app; it is stored in the Keychain.
  3. Register a folder. This is the folder an agent will work in. Registration is explicit and per-folder. AgentRoom will not touch anything you have not registered.
  4. Start the backend. The Mac app launches and supervises it. It listens on port 8787 and binds to all interfaces so the headset can find it.

To check it is running, open http://localhost:8787 on the Mac. There is a debug page there, and a health check at http://localhost:8787/health.

Connect the headset

Open AgentRoom on the Vision Pro and enter your Mac's address.

On a physical headset, use the Mac's Bonjour hostname or its address on the local network:

http://your-mac.local:8787

You can find the hostname in System Settings under Sharing, as the local hostname. Paste the bearer token when prompted.

The simulator connects to http://localhost:8787 by default and needs no address entered.

Provider keys stay on the Mac. Do not put them on the headset; nothing on the headset asks for them.

Your first turn

Open a workspace, start a thread, and send a turn. You should see assistant text, reasoning, tool activity, and any plan or diff the agent produces stream in as it works.

Threads persist. You can close the app, restart the Mac backend, and come back to the same conversation. If an agent cannot resume a thread after a restart, AgentRoom tells you in a system message on that thread rather than quietly starting a new conversation under the old name.

If it does not connect

  • Check both devices are on the same network. A guest network or a VPN on either device will break this.
  • Check the Mac is awake. A sleeping Mac is an unreachable backend. Check your energy settings if it keeps dropping.
  • Try the address in Safari on the headset. If http://your-mac.local:8787/health does not load there, the problem is the network or the hostname, not AgentRoom.
  • Use the LAN address if Bonjour fails. Some networks block .local resolution. The Mac's local network address works too.
  • Check the token matches. A wrong token fails every mutating request while leaving the health check working, which looks like a connection problem but is not.

Where next