@multiplayer-app/cli

@multiplayer-app/debugging-agent

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

Install

npm install -g @multiplayer-app/debugging-agent

Commands

Command	Description
multiplayer	Start the debugging agent (TUI by default)
multiplayer releases create	Register a release
multiplayer deployments create	Register a deployment
multiplayer sourcemaps upload	Upload sourcemap files

Debugging Agent

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

multiplayer [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 profiles

Create a .multiplayer/config file in your project directory or home directory (~/.multiplayer/config). Uses INI format — the same as AWS credentials.

[default]
api_key    = <your-api-key>
dir        = /path/to/repo
model      = claude-sonnet-4-6
max_concurrent = 2

[staging]
api_key    = <staging-api-key>
dir        = /path/to/staging-repo
model      = gpt-4o
model_key  = <openai-api-key>

All supported profile keys:

Key	Description
api_key	Multiplayer API key
dir	Project directory
model	AI model name
model_key	AI provider API key
model_url	Base URL for OpenAI-compatible APIs
name	Agent name
url	Multiplayer API base URL
max_concurrent	Max parallel issues
no_git_branch	true to skip branch/worktree creation

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>	VERSION	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