Multiplayer OS

Interfaces

CLI Reference

Use `mos` as the scriptable interface between local agents and the Multiplayer OS app.

Commands

mos doctor [--json]
mos status [--json]
mos workspace [current] [--json]
mos workspace list [--json]
mos workspace suggest [--workspace NAME_OR_ID] [--workspace-id ID] [--json]
mos workspace map [--path PATH] [--git-remote [REMOTE]] [--default] --workspace NAME_OR_ID
mos workspace rules [--json]
mos event validate --file FILE|- [--consent local-user-granted|workspace-policy-granted] [--json]
mos event submit --file FILE|- [--workspace NAME_OR_ID] [--workspace-id ID] [--consent local-user-granted|workspace-policy-granted] [--dry-run] [--json]
mos skill status [SKILL_ID] [--json]
mos skill install TOOL_ID [--skill SKILL_ID] [--json]
mos skill update TOOL_ID [--skill SKILL_ID] [--json]

Rules for agents

  • Submit only through mos event submit --file -.
  • Let the menu bar app handle credentials and workspace selection.
  • Include useful sourceRefs so routing can pick the right workspace.
  • Use idempotencyKey for repeatable reports and retry-safe submissions.
  • Run mos doctor before a skill performs its first submission.

Workspace routing

Workspace routing uses the current directory, git remote, explicit CLI flags, and local rules in ~/.mos/workspace-rules.json. The user can still change the destination workspace from the menu bar review item before approval.

mos workspace suggest
mos workspace map --path /path/to/project --workspace WORKSPACE_NAME
mos workspace map --git-remote --workspace WORKSPACE_NAME
mos workspace map --default --workspace WORKSPACE_NAME
mos workspace rules