@multiplayer-app/cli 1.3.36 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,20 @@
1
+
2
+ 
3
+ > @multiplayer-app/cli@1.3.36 build /Users/dima/Projects/multiplayer-debugger-javascript/packages/cli
4
+ > bun build src/index.tsx --outdir dist --target bun --format esm --sourcemap=none && rm -f dist/index.js.map
5
+
6
+ Bundled 905 modules in 160ms
7
+
8
+ index.js 6.96 MB (entry point)
9
+ highlights-ghv9g403.scm 2.86 KB (asset)
10
+ tree-sitter-javascript-nd0q4pe9.wasm 0.41 MB (asset)
11
+ highlights-eq9cgrbb.scm 9.83 KB (asset)
12
+ tree-sitter-typescript-zxjzwt75.wasm 1.41 MB (asset)
13
+ highlights-r812a2qc.scm 3.44 KB (asset)
14
+ tree-sitter-markdown-411r6y9b.wasm 0.42 MB (asset)
15
+ injections-73j83es3.scm 0.82 KB (asset)
16
+ highlights-x6tmsnaa.scm 2.15 KB (asset)
17
+ tree-sitter-markdown_inline-j5349f42.wasm 0.43 MB (asset)
18
+ highlights-hk7bwhj4.scm 3.48 KB (asset)
19
+ tree-sitter-zig-e78zbjpm.wasm 0.69 MB (asset)
20
+
@@ -0,0 +1,5 @@
1
+
2
+ 
3
+ > @multiplayer-app/cli@1.3.36 lint /Users/dima/Projects/multiplayer-debugger-javascript/packages/cli
4
+ > eslint src/**/*.ts --config eslint.config.js
5
+
package/README.md CHANGED
@@ -1,54 +1,174 @@
1
- # Overview
1
+ # @multiplayer-app/debugging-agent
2
2
 
3
- This module is for creating release and deployment. It can be used from the command line or programatically from a node script.
3
+ AI-powered debugging agent and release management CLI for [Multiplayer](https://multiplayer.app).
4
4
 
5
- ## Command Line
5
+ ## Install
6
6
 
7
- ### Install
7
+ ```sh
8
+ npm install -g @multiplayer-app/debugging-agent
9
+ ```
10
+
11
+ ## Commands
12
+
13
+ | Command | Description |
14
+ |---------|-------------|
15
+ | `multiplayer` | Start the debugging agent (TUI by default) |
16
+ | `multiplayer releases create` | Register a release |
17
+ | `multiplayer deployments create` | Register a deployment |
18
+ | `multiplayer sourcemaps upload` | Upload sourcemap files |
8
19
 
9
- In order to create release or deployment from the command line, install the library globally.
20
+ ---
10
21
 
22
+ ## Debugging Agent
23
+
24
+ Connects to the Multiplayer backend and automatically resolves incoming issues using AI.
25
+
26
+ ```sh
27
+ multiplayer [options]
11
28
  ```
12
- npm install -g @multiplayer-app/cli
29
+
30
+ Options are resolved in this order: **CLI flag → environment variable → config profile**.
31
+
32
+ | Flag | Env var | Description |
33
+ |------|---------|-------------|
34
+ | `--api-key <key>` | `MULTIPLAYER_API_KEY` | Multiplayer API key |
35
+ | `--dir <path>` | `MULTIPLAYER_DIR` | Project directory (must be a git repo) |
36
+ | `--model <name>` | `AI_MODEL` | AI model (e.g. `claude-sonnet-4-6`, `gpt-4o`) |
37
+ | `--model-key <key>` | `AI_API_KEY` | AI provider API key (not required for Claude models) |
38
+ | `--model-url <url>` | `AI_BASE_URL` | Base URL for OpenAI-compatible APIs |
39
+ | `--headless` | `MULTIPLAYER_HEADLESS=true` | Run without TUI — outputs structured JSON logs |
40
+ | `--profile <name>` | `MULTIPLAYER_PROFILE` | Config profile to load (default: `default`) |
41
+ | `--name <name>` | `MULTIPLAYER_AGENT_NAME` | Agent name (defaults to hostname) |
42
+ | `--max-concurrent <n>` | `MULTIPLAYER_MAX_CONCURRENT` | Max issues resolved in parallel (default: `2`) |
43
+ | `--no-git-branch` | `MULTIPLAYER_NO_GIT_BRANCH=true` | Work in current branch — no worktree, no push |
44
+ | `--health-port <port>` | `MULTIPLAYER_HEALTH_PORT` | HTTP health check port (headless mode only) |
45
+ | `--url <url>` | `MULTIPLAYER_URL` | Multiplayer API base URL |
46
+
47
+ ### TUI mode (default)
48
+
49
+ An interactive terminal dashboard that shows active sessions and live logs.
50
+
51
+ ```sh
52
+ multiplayer --api-key <key> --dir /path/to/repo --model claude-sonnet-4-6
13
53
  ```
14
54
 
15
- ### Usage
55
+ ### Headless mode
56
+
57
+ Outputs newline-delimited JSON logs — suitable for CI, containers, and log aggregators.
58
+
59
+ ```sh
60
+ multiplayer --headless --api-key <key> --dir /path/to/repo --model claude-sonnet-4-6
61
+ ```
62
+
63
+ In headless mode, `SIGTERM` waits for active sessions to finish before exiting; `SIGINT` exits immediately.
64
+
65
+ ### Config profiles
16
66
 
17
- Options can be provided on the command line or as environment variables.
67
+ Create a `.multiplayer/config` file in your project directory or home directory (`~/.multiplayer/config`). Uses INI format — the same as AWS credentials.
18
68
 
19
- ##### Create release:
69
+ ```ini
70
+ [default]
71
+ api_key = <your-api-key>
72
+ dir = /path/to/repo
73
+ model = claude-sonnet-4-6
74
+ max_concurrent = 2
20
75
 
76
+ [staging]
77
+ api_key = <staging-api-key>
78
+ dir = /path/to/staging-repo
79
+ model = gpt-4o
80
+ model_key = <openai-api-key>
21
81
  ```
22
- multiplayer-app-cli releases create --apiKey=[apiKey] --service=[name] --release=[release] --releaseNotes=[releaseNotes]
23
82
 
24
- Options:
25
- --apiKey Multiplayer personal user API key (MULTIPLAYER_API_KEY)
26
- --service Service name (SERVICE_NAME)
27
- --release Service release (RELEASE)
28
- --commitHash [Optional] Repository URL (REPOSITORY_URL)
29
- --releaseNotes [Optional] Release notes (RELEASE_NOTES)
83
+ All supported profile keys:
84
+
85
+ | Key | Description |
86
+ |-----|-------------|
87
+ | `api_key` | Multiplayer API key |
88
+ | `dir` | Project directory |
89
+ | `model` | AI model name |
90
+ | `model_key` | AI provider API key |
91
+ | `model_url` | Base URL for OpenAI-compatible APIs |
92
+ | `name` | Agent name |
93
+ | `url` | Multiplayer API base URL |
94
+ | `max_concurrent` | Max parallel issues |
95
+ | `no_git_branch` | `true` to skip branch/worktree creation |
96
+
97
+ ---
98
+
99
+ ## Releases
100
+
101
+ ```sh
102
+ multiplayer releases create [options]
103
+ ```
104
+
105
+ | Flag | Env var | Description |
106
+ |------|---------|-------------|
107
+ | `--api-key <key>` | `MULTIPLAYER_API_KEY` | Multiplayer API key |
108
+ | `--service <name>` | `SERVICE_NAME` | Service name |
109
+ | `--release-version <version>` | `RELEASE` | Release version |
110
+ | `--commit-hash <hash>` | `COMMIT_HASH` | Commit hash |
111
+ | `--repository-url <url>` | `REPOSITORY_URL` | Repository URL |
112
+ | `--release-notes <notes>` | `RELEASE_NOTES` | Release notes (optional) |
113
+ | `--base-url <url>` | `BASE_URL` | API base URL (optional) |
114
+
115
+ **Example:**
116
+
117
+ ```sh
118
+ multiplayer releases create \
119
+ --api-key $MULTIPLAYER_API_KEY \
120
+ --service my-service \
121
+ --release-version 1.2.3 \
122
+ --commit-hash abc123 \
123
+ --repository-url https://github.com/org/repo
30
124
  ```
31
125
 
32
- ##### To create deployment:
126
+ ---
127
+
128
+ ## Deployments
33
129
 
130
+ ```sh
131
+ multiplayer deployments create [options]
34
132
  ```
35
- multiplayer-app-cli deployments create --apiKey=[apiKey] --service=[name] --release=[release] --environment=[environment]
36
133
 
37
- Options:
38
- --apiKey Multiplayer personal user API key (MULTIPLAYER_API_KEY)
39
- --service Service name (SERVICE_NAME)
40
- --release Service release (RELEASE)
41
- --environment [Optional] Environment name (ENVIRONMENT)
134
+ | Flag | Env var | Description |
135
+ |------|---------|-------------|
136
+ | `--api-key <key>` | `MULTIPLAYER_API_KEY` | Multiplayer API key |
137
+ | `--service <name>` | `SERVICE_NAME` | Service name |
138
+ | `--release <version>` | `VERSION` | Release version |
139
+ | `--environment <name>` | `ENVIRONMENT` | Environment name |
140
+ | `--base-url <url>` | `BASE_URL` | API base URL (optional) |
141
+
142
+ **Example:**
143
+
144
+ ```sh
145
+ multiplayer deployments create \
146
+ --api-key $MULTIPLAYER_API_KEY \
147
+ --service my-service \
148
+ --release 1.2.3 \
149
+ --environment production
42
150
  ```
43
151
 
44
- ### Upload sourcemap
152
+ ---
153
+
154
+ ## Sourcemaps
45
155
 
156
+ ```sh
157
+ multiplayer sourcemaps upload <directories...> [options]
46
158
  ```
47
- multiplayer-app-cli sourcemap upload /path/to/directory --apiKey=[apiKey] --service=[name] --release=[release] --environment=[environment]
48
159
 
49
- Options:
50
- --apiKey Multiplayer personal user API key (MULTIPLAYER_API_KEY)
51
- --service Service name (SERVICE_NAME)
52
- --release Service release (RELEASE)
53
- --environment [Optional] Environment name (ENVIRONMENT)
160
+ | Flag | Env var | Description |
161
+ |------|---------|-------------|
162
+ | `--api-key <key>` | `MULTIPLAYER_API_KEY` | Multiplayer API key |
163
+ | `--service <name>` | `SERVICE_NAME` | Service name |
164
+ | `--release <version>` | `RELEASE` | Release version |
165
+ | `--base-url <url>` | `BASE_URL` | API base URL (optional) |
166
+
167
+ **Example:**
168
+
169
+ ```sh
170
+ multiplayer sourcemaps upload ./dist ./build \
171
+ --api-key $MULTIPLAYER_API_KEY \
172
+ --service my-service \
173
+ --release 1.2.3
54
174
  ```