@multiplayer-app/cli

@multiplayer-app/cli

AI-powered debugging agent and release management CLI for Multiplayer.

Install

npm install -g @multiplayer-app/cli

Supports macOS (arm64, x64), Linux (arm64, x64), and Windows (arm64, x64). The correct platform binary is installed automatically.

Commands

Command	Description
multiplayer [agent]	Start the debugging agent (default)
multiplayer releases create	Register a release
multiplayer deployments create	Register a deployment
multiplayer sourcemaps upload	Upload sourcemap files
multiplayer auth login	Log in via browser OAuth
multiplayer auth logout	Log out and clear credentials
multiplayer auth status	Check authentication status
multiplayer mcp	Start an MCP server for AI agent integration

Debugging Agent

Connects to the Multiplayer backend and automatically resolves incoming issues using AI.

multiplayer [agent] [options]

Options are resolved in this order: CLI flag → environment variable → config profile.

Flag	Env var	Description
--api-key <key>	MULTIPLAYER_API_KEY	Multiplayer API key
--dir <path>	MULTIPLAYER_DIR	Project directory (must be a git repo)
--model <name>	AI_MODEL	AI model (e.g. claude-sonnet-4-6, gpt-4o)
--model-key <key>	AI_API_KEY	AI provider API key (not required for Claude models)
--model-url <url>	AI_BASE_URL	Base URL for OpenAI-compatible APIs
--headless	MULTIPLAYER_HEADLESS=true	Run without TUI — outputs structured JSON logs
--profile <name>	MULTIPLAYER_PROFILE	Config profile to load (default: default)
--name <name>	MULTIPLAYER_AGENT_NAME	Agent name (defaults to hostname)
--max-concurrent <n>	MULTIPLAYER_MAX_CONCURRENT	Max issues resolved in parallel (default: 2)
--no-git-branch	MULTIPLAYER_NO_GIT_BRANCH=true	Work in current branch — no worktree, no push
--health-port <port>	MULTIPLAYER_HEALTH_PORT	HTTP health check port (headless mode only)
--url <url>	MULTIPLAYER_URL	Multiplayer API base URL

TUI mode (default)

An interactive terminal dashboard that shows active sessions and live logs.

multiplayer --api-key <key> --dir /path/to/repo --model claude-sonnet-4-6

Headless mode

Outputs newline-delimited JSON logs — suitable for CI, containers, and log aggregators.

multiplayer --headless --api-key <key> --dir /path/to/repo --model claude-sonnet-4-6

In headless mode, SIGTERM waits for active sessions to finish before exiting; SIGINT exits immediately.

Config files

Configuration is split across two JSON files:

~/.multiplayer/credentials.json — authentication, one entry per account (keyed by email):

{
  "[e-mail]": {
    "apiKey": "<your-api-key>",
    "authType": "api_key",
    "url": "https://api.multiplayer.app"
  }
}

<project-dir>/.multiplayer/settings.json — per-project settings:

{
  "model": "claude-sonnet-4-6",
  "maxConcurrentIssues": 2,
  "noGitBranch": false,
  "git": {
    "commit": true,
    "branch_create": true,
    "pr_create": true,
    "push": true,
    "use_worktree": true
  }
}

Supported project settings keys:

Key	Description
model	AI model name
modelKey	AI provider API key
modelUrl	Base URL for OpenAI-compatible APIs
name	Agent name
maxConcurrentIssues	Max parallel issues
noGitBranch	true to skip branch/worktree creation
git.commit	Allow committing changes
git.branch_create	Allow creating branches
git.pr_create	Allow opening pull requests
git.push	Allow pushing to remote
git.use_worktree	Use git worktrees for isolation

Auth

multiplayer auth login    # Log in via browser OAuth flow
multiplayer auth logout   # Log out and clear stored credentials
multiplayer auth status   # Check current authentication status

Releases

multiplayer releases create [options]

Flag	Env var	Description
--api-key <key>	MULTIPLAYER_API_KEY	Multiplayer API key
--service <name>	SERVICE_NAME	Service name
--release-version <version>	RELEASE	Release version
--commit-hash <hash>	COMMIT_HASH	Commit hash
--repository-url <url>	REPOSITORY_URL	Repository URL
--release-notes <notes>	RELEASE_NOTES	Release notes (optional)
--base-url <url>	BASE_URL	API base URL (optional)

Example:

multiplayer releases create \
  --api-key $MULTIPLAYER_API_KEY \
  --service my-service \
  --release-version 1.2.3 \
  --commit-hash abc123 \
  --repository-url https://github.com/org/repo

Deployments

multiplayer deployments create [options]

Flag	Env var	Description
--api-key <key>	MULTIPLAYER_API_KEY	Multiplayer API key
--service <name>	SERVICE_NAME	Service name
--release <version>	RELEASE	Release version
--environment <name>	ENVIRONMENT	Environment name
--base-url <url>	BASE_URL	API base URL (optional)

Example:

multiplayer deployments create \
  --api-key $MULTIPLAYER_API_KEY \
  --service my-service \
  --release 1.2.3 \
  --environment production

Sourcemaps

multiplayer sourcemaps upload <directories...> [options]

Flag	Env var	Description
--api-key <key>	MULTIPLAYER_API_KEY	Multiplayer API key
--service <name>	SERVICE_NAME	Service name
--release <version>	RELEASE	Release version
--base-url <url>	BASE_URL	API base URL (optional)

Example:

multiplayer sourcemaps upload ./dist ./build \
  --api-key $MULTIPLAYER_API_KEY \
  --service my-service \
  --release 1.2.3

MCP Server

multiplayer mcp starts an MCP server over stdio, exposing Multiplayer operations as tools that AI agents (Claude Desktop, Claude Code, Cursor, etc.) can call directly.

Tools

Tool	Description
create_release	Register a release for a service
create_deployment	Deploy a release to an environment
upload_sourcemaps	Upload .map files from local directories

Setup

Add the server to your MCP client config. Example for Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "multiplayer": {
      "command": "multiplayer",
      "args": ["mcp"],
      "env": {
        "MULTIPLAYER_API_KEY": "<your-api-key>"
      }
    }
  }
}

Example for Claude Code (~/.claude/mcp.json):

{
  "mcpServers": {
    "multiplayer": {
      "command": "multiplayer",
      "args": ["mcp"],
      "env": {
        "MULTIPLAYER_API_KEY": "<your-api-key>"
      }
    }
  }
}

Once configured, the AI can create releases, deployments, and upload sourcemaps without any shell commands or manual steps.

License

MIT — see LICENSE.