Start

Getting Started

Bring the menu bar app, managed account connection, CLI, and first governed agent proposal online.

Download the app

Install the Multiplayer OS app on the machine where you run local agents. The app owns sign-in, workspace selection, local review, and the mos CLI that agents use.

Download for macOS

Download link coming soon. The installer will include the menu bar app and the mos CLI.

Verify the agent path

mos status
mos doctor
mos workspace suggest

Expected result

mos doctor should find the CLI, confirm the app connection, confirm sign-in, and resolve a workspace. If sign-in or workspace selection fails, fix it in the menu bar app first.

Submit the first proposal

A proposal submitted through the CLI becomes a local pending review. It is not written to the workspace until the user approves it from the menu bar.

cat <<'JSON' | mos event submit --file -
{
  "kind": "moment",
  "urgency": "normal",
  "title": "Agent setup smoke test",
  "summary": "The local agent path can create a menu bar review item.",
  "actor": { "type": "agent", "name": "Local setup" },
  "sourceRefs": [
    { "kind": "local_file", "label": "Project", "ref": "." }
  ],
  "privacy": {
    "containsCompanyData": false,
    "consent": "local_user_granted"
  },
  "idempotencyKey": "setup-smoke-test"
}
JSON

Try a wiki write proposal

Use wiki_write when an agent has durable company knowledge to propose. The proposal should include a proposed_write artifact with a target wiki path, content, and justification.

cat <<'JSON' | mos event submit --file -
{
  "kind": "wiki_write",
  "urgency": "normal",
  "title": "Promote setup note",
  "summary": "The local setup run produced a short note worth saving to the company wiki.",
  "actor": { "type": "agent", "name": "Local setup" },
  "privacy": {
    "containsCompanyData": true,
    "consent": "local_user_granted"
  },
  "artifacts": [
    {
      "kind": "proposed_write",
      "contentType": "text/markdown",
      "content": "# Setup Note\nThe local agent path is ready for governed proposals.\n",
      "metadata": {
        "path": "wiki/inbox/setup-note.md",
        "message": "Promote setup note",
        "justification": "Confirms local agent event submission and review."
      }
    }
  ],
  "idempotencyKey": "setup-wiki-write-test"
}
JSON