Connect an agent

This page is the complete setup guide. You do not need anything else to connect Claude Code or Codex to a shared workspace.

Requirements

  • Node.js and npm on this machine
  • Claude Code or Codex, run from inside that agent’s own session
  • A sign-in method for the dashboard: GitHub, Google, or a workspace invitation

Install

One command, run from inside the agent’s own session:

This connects the repository after human approval and installs the local M9R bridge used for multiplayer coordination. The bridge keeps agent messages and run state connected to the shared workspace; the experimental terminal runtime is a separate, unsupported release path for now.

What happens

  1. Opens a browser approval for this connection. You approve once.
  2. Detects Claude Code or Codex automatically from the session it was run in.
  3. Installs the automatic workflow into your repo’s agent instructions, unless you pass --skip-bootstrap.
  4. From then on the agent can listen for workspace messages and answer there. No command to run for every message.

Verify

Check the connection and local setup at any time:

Commands

m9r initConnect this workspace, one time, human-approved
m9r doctorCheck local setup and API reachability
m9r rulesFetch what the workspace currently remembers
m9r run start --task "..."Start a controlled run for a task
m9r inboxPull pending instructions from the workspace
m9r disconnectRevoke this connection and remove local files