@multiplayer-app/cli 1.3.36 → 2.0.0

package/.turbo/turbo-build.log

@@ -0,0 +1,20 @@
+
+
+> @multiplayer-app/cli@1.3.36 build /Users/dima/Projects/multiplayer-debugger-javascript/packages/cli
+> bun build src/index.tsx --outdir dist --target bun --format esm --sourcemap=none && rm -f dist/index.js.map
+
+Bundled 905 modules in 160ms
+
+  index.js                                    6.96 MB  (entry point)
+  highlights-ghv9g403.scm                     2.86 KB  (asset)
+  tree-sitter-javascript-nd0q4pe9.wasm        0.41 MB  (asset)
+  highlights-eq9cgrbb.scm                     9.83 KB  (asset)
+  tree-sitter-typescript-zxjzwt75.wasm        1.41 MB  (asset)
+  highlights-r812a2qc.scm                     3.44 KB  (asset)
+  tree-sitter-markdown-411r6y9b.wasm          0.42 MB  (asset)
+  injections-73j83es3.scm                     0.82 KB  (asset)
+  highlights-x6tmsnaa.scm                     2.15 KB  (asset)
+  tree-sitter-markdown_inline-j5349f42.wasm   0.43 MB  (asset)
+  highlights-hk7bwhj4.scm                     3.48 KB  (asset)
+  tree-sitter-zig-e78zbjpm.wasm               0.69 MB  (asset)
+

package/.turbo/turbo-lint.log

@@ -0,0 +1,5 @@
+
+
+> @multiplayer-app/cli@1.3.36 lint /Users/dima/Projects/multiplayer-debugger-javascript/packages/cli
+> eslint src/**/*.ts --config eslint.config.js
+

package/README.md

@@ -1,54 +1,147 @@
-# Overview
+# @multiplayer-app/debugging-agent
 
-This module is for creating release and deployment. It can be used from the command line or programatically from a node script.
+Multiplayer CLI — AI-powered debugging agent and release management tool.
 
-## Command Line
+## Install
 
-### Install
+```
+npm install -g @multiplayer-app/debugging-agent
+```
+
+## Usage
+
+```
+multiplayer [command] [options]
+```
+
+If no command is provided, the debugging agent starts in TUI mode.
+
+---
+
+## Debugging Agent
+
+Automatically resolves issues using AI. Connects to the Multiplayer backend and processes incoming issues in real time.
+
+```
+multiplayer [options]
+```
+
+Options can be provided as flags, environment variables, or a `.multiplayer/config` profile file.
+
+| 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` | API key for the AI provider (not needed for Claude) |
+| `--model-url <url>` | `AI_BASE_URL` | Optional base URL for OpenAI-compatible APIs |
+| `--headless` | `MULTIPLAYER_HEADLESS=true` | Run without TUI, outputs structured JSON logs |
+| `--profile <name>` | `MULTIPLAYER_PROFILE` | Config profile to use (default: `default`) |
+| `--name <name>` | `MULTIPLAYER_AGENT_NAME` | Agent name (defaults to hostname) |
+| `--max-concurrent <n>` | `MULTIPLAYER_MAX_CONCURRENT` | Max parallel issues (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 only) |
+| `--url <url>` | `MULTIPLAYER_URL` | Multiplayer API base URL |
+
+### TUI mode (default)
+
+```
+multiplayer --api-key <key> --dir /path/to/repo --model claude-sonnet-4-6
+```
 
-In order to create release or deployment from the command line, install the library globally.
+### Headless mode
 
 ```
-npm install -g @multiplayer-app/cli
+multiplayer --headless --api-key <key> --dir /path/to/repo --model claude-sonnet-4-6
 ```
 
-### Usage
+### Config profiles
 
-Options can be provided on the command line or as environment variables.
+Create a `.multiplayer/config` file in your project or home directory:
 
-##### Create release:
+```ini
+[default]
+api_key = <your-api-key>
+dir = /path/to/repo
+model = claude-sonnet-4-6
+max_concurrent = 2
+```
+
+---
+
+## Releases
 
 ```
-multiplayer-app-cli releases create --apiKey=[apiKey] --service=[name] --release=[release] --releaseNotes=[releaseNotes]
+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) |
 
-Options:
-  --apiKey         Multiplayer personal user API key (MULTIPLAYER_API_KEY)
-  --service        Service name (SERVICE_NAME)
-  --release        Service release (RELEASE)
-  --commitHash     [Optional] Repository URL (REPOSITORY_URL)
-  --releaseNotes   [Optional] Release notes (RELEASE_NOTES)
+**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
 ```
 
-##### To create deployment:
+---
 
+## Deployments
+
+```
+multiplayer deployments create [options]
 ```
-multiplayer-app-cli deployments create --apiKey=[apiKey] --service=[name] --release=[release] --environment=[environment]
 
-Options:
-  --apiKey         Multiplayer personal user API key (MULTIPLAYER_API_KEY)
-  --service        Service name (SERVICE_NAME)
-  --release        Service release (RELEASE)
-  --environment    [Optional] Environment name (ENVIRONMENT)
+| 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
+```
+
+---
 
-### Upload sourcemap
+## Sourcemaps
 
 ```
-multiplayer-app-cli sourcemap upload /path/to/directory --apiKey=[apiKey] --service=[name] --release=[release] --environment=[environment]
+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) |
 
-Options:
-  --apiKey         Multiplayer personal user API key (MULTIPLAYER_API_KEY)
-  --service        Service name (SERVICE_NAME)
-  --release        Service release (RELEASE)
-  --environment    [Optional] Environment name (ENVIRONMENT)
+**Example:**
+
+```
+multiplayer sourcemaps upload ./dist ./build \
+  --api-key $MULTIPLAYER_API_KEY \
+  --service my-service \
+  --release 1.2.3
 ```