@tryarcanist/cli 0.1.255 → 0.1.257
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.
- package/README.md +1 -75
- package/dist/index.js +2157 -2497
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -15,7 +15,6 @@ Requires Node.js 22 or newer.
|
|
|
15
15
|
```bash
|
|
16
16
|
arcanist auth login # paste a token from Settings > CLI
|
|
17
17
|
arcanist sessions create https://github.com/your-org/your-repo "fix the login bug"
|
|
18
|
-
arcanist sessions create https://github.com/your-org/your-repo "fix ARC-1635" --linear-issue https://linear.app/team/issue/ARC-1635/fix-login
|
|
19
18
|
```
|
|
20
19
|
|
|
21
20
|
```bash
|
|
@@ -201,7 +200,7 @@ arcanist sessions create your-org/your-repo "retry-safe create" --idempotency-ke
|
|
|
201
200
|
|
|
202
201
|
`--wait` blocks until the created prompt finishes, prints the resulting PR/branch line in human-readable mode when it is already available, and exits non-zero if the prompt finishes with `status: failed`, making it suitable for cron or other schedulers that alert on command failure. JSON mode waits quietly and prints the create payload after the prompt completes successfully. `--poll-interval <ms>` tunes the completion check frequency.
|
|
203
202
|
|
|
204
|
-
`--auto-verify` is a deprecated no-op. The verifier child is no longer spawned at publish
|
|
203
|
+
`--auto-verify` is a deprecated no-op. The verifier child is no longer spawned at publish. The flag is accepted for backward compatibility and no longer starts a verifier.
|
|
205
204
|
|
|
206
205
|
Use `--browser-identity <id|none>` to attach a business browser identity to the session, or pass `none` to explicitly start without one. Access is authorized by the control plane when the session is created.
|
|
207
206
|
|
|
@@ -211,11 +210,6 @@ Use `--start-branch <branch>` to resume an existing branch with its history inst
|
|
|
211
210
|
|
|
212
211
|
Use `--continue-pr <url>` to continue an open same-repo pull request. The control plane checks out the PR head branch before the prompt runs. `--continue-mode update-pr` updates the referenced PR; `--continue-mode new-pr` starts from that PR head but leaves publish free to open a fresh PR. `auto` is the default and currently resolves to same-PR update for supported open same-repo PRs.
|
|
213
212
|
|
|
214
|
-
Use `--linear-issue <id|url>` to attach a Linear issue reference to the created session.
|
|
215
|
-
The CLI echoes the request value as `linearIssue` in JSON output; pickup writeback occurs after the first prompt is durably enqueued.
|
|
216
|
-
Use `--jira-issue <key|url>` to attach a Jira issue reference to the created session.
|
|
217
|
-
The CLI echoes the request value as `jiraIssue` in JSON output; pickup writeback occurs after the first prompt is durably enqueued.
|
|
218
|
-
|
|
219
213
|
Repeatable `--uploaded-file <path>` flags attach local UTF-8 text files to the prompt. Uploaded file names come from the local basename; directory components are not sent.
|
|
220
214
|
|
|
221
215
|
Sessions always start from a fresh sandbox (the warm sandbox pool was removed).
|
|
@@ -227,36 +221,6 @@ The CLI derives separate session and prompt idempotency keys from the provided v
|
|
|
227
221
|
|
|
228
222
|
JSON mode returns `{sessionId, sessionUrl?, repoUrl, model?, reasoningEffort?, autoVerify?, baseBranch?, startBranch?, continuePrUrl?, continueMode?, onboarding?, promptId?}`. With `--wait`, JSON mode also includes best-effort result fields when available: `prUrl?`, `publishedBranch?`, and `lastBranch?`.
|
|
229
223
|
|
|
230
|
-
### `arcanist sessions qa <pr-url>`
|
|
231
|
-
|
|
232
|
-
Starts a QA verification session for an existing GitHub pull request.
|
|
233
|
-
|
|
234
|
-
```bash
|
|
235
|
-
arcanist sessions qa https://github.com/your-org/your-repo/pull/123
|
|
236
|
-
arcanist sessions qa https://github.com/your-org/your-repo/pull/123 --model gpt-5.4
|
|
237
|
-
arcanist sessions qa https://github.com/your-org/your-repo/pull/123 --reasoning-effort xhigh
|
|
238
|
-
arcanist sessions qa https://github.com/your-org/your-repo/pull/123 --wait
|
|
239
|
-
arcanist sessions qa https://github.com/your-org/your-repo/pull/123 --idempotency-key 1f0e6f1a-...
|
|
240
|
-
```
|
|
241
|
-
|
|
242
|
-
The PR URL must be `https://github.com/<owner>/<repo>/pull/<number>`.
|
|
243
|
-
The CLI derives the repo from that URL, creates a QA session with `qa: true` and `targetPrUrl`, then enqueues the verifier prompt (skipped when the server signals `promptAlreadyEnqueued`).
|
|
244
|
-
Inspect progress with the session URL or the session events stream.
|
|
245
|
-
|
|
246
|
-
`--model` pins the model for the QA session, and the CLI rejects an unknown model before any network call.
|
|
247
|
-
When `--model` is omitted, the default is used.
|
|
248
|
-
|
|
249
|
-
`--wait` blocks until the enqueued QA prompt finishes and exits non-zero if the prompt fails.
|
|
250
|
-
JSON mode waits quietly and prints the create payload after the prompt completes successfully.
|
|
251
|
-
`--poll-interval <ms>` tunes completion polling.
|
|
252
|
-
|
|
253
|
-
`--idempotency-key <uuid>` is for manually retrying a QA request that may have reached the server.
|
|
254
|
-
The CLI derives separate session and prompt idempotency keys from the provided value.
|
|
255
|
-
If session creation succeeds but prompt enqueue fails, retry the same command with the same `--idempotency-key`.
|
|
256
|
-
|
|
257
|
-
JSON mode returns `{sessionId, sessionUrl?, repoUrl, targetPrUrl, model?, reasoningEffort?, promptId?}`.
|
|
258
|
-
`promptId` is absent when the coordinator already enqueued the verifier prompt (no duplicate send). Active-verifier and per-PR run-limit conflicts both use exit code `4`; active-verifier errors include the existing session handle when the server returns it.
|
|
259
|
-
|
|
260
224
|
### `arcanist sessions send <session-id> [prompt]`
|
|
261
225
|
|
|
262
226
|
Sends a follow-up message to an existing session.
|
|
@@ -423,44 +387,6 @@ arcanist models list --json
|
|
|
423
387
|
|
|
424
388
|
JSON mode returns `{models}`.
|
|
425
389
|
|
|
426
|
-
### `arcanist automations create <repo-url> [prompt]`
|
|
427
|
-
|
|
428
|
-
Creates a scheduled automation for a GitHub repo. Create/delete require a write-scoped CLI token; read-scoped tokens can list automations. The server validates repo access, normalizes cron expressions, dedupes retries by repo+cron+prompt, and caps each business at 20 enabled rules.
|
|
429
|
-
|
|
430
|
-
```bash
|
|
431
|
-
arcanist automations create your-org/your-repo "summarize new regressions" --cron "*/15 * * * *"
|
|
432
|
-
arcanist automations create your-org/your-repo "audit N+1s" --cron "0 13 * * 5" --model gpt-5.5
|
|
433
|
-
arcanist automations create your-org/your-repo "/audit-prod-docs https://docs.tryarcanist.com/" --cron "0 8 * * *" --slack-team-id T0123ABC --slack-channel-id C0456DEF
|
|
434
|
-
printf "summarize new regressions" | arcanist automations create your-org/your-repo --prompt-stdin --cron "*/15 * * * *" --json
|
|
435
|
-
arcanist automations create https://github.com/your-org/your-repo - --cron "0 14 * * 1-5" --name "Weekday summary"
|
|
436
|
-
```
|
|
437
|
-
|
|
438
|
-
Use `--model <model>` to pin the model for sessions started by the automation. When `--model` is omitted the Codex default is used.
|
|
439
|
-
|
|
440
|
-
Use `--slack-team-id <team-id>` together with `--slack-channel-id <channel-id>` to deliver each completed automation digest into a Slack channel. Both flags are required together; the target workspace must already be connected to Arcanist and the bot must already be in the channel.
|
|
441
|
-
|
|
442
|
-
JSON mode prints the created rule. Human-readable mode prints the rule ID, repo, normalized cron, and next fire time.
|
|
443
|
-
|
|
444
|
-
### `arcanist automations list`
|
|
445
|
-
|
|
446
|
-
```bash
|
|
447
|
-
arcanist automations list
|
|
448
|
-
arcanist automations list --limit 20 --json
|
|
449
|
-
arcanist automations list --cursor <cursor>
|
|
450
|
-
arcanist automations list --all --json
|
|
451
|
-
```
|
|
452
|
-
|
|
453
|
-
Default output reads one page. `--all` follows pagination until completion. JSON mode returns `{items, nextCursor}`.
|
|
454
|
-
|
|
455
|
-
### `arcanist automations delete <id>`
|
|
456
|
-
|
|
457
|
-
Deletes a scheduled automation. Interactive mode prompts for confirmation; pass `--yes` for non-interactive use. `--json` requires `--yes`.
|
|
458
|
-
|
|
459
|
-
```bash
|
|
460
|
-
arcanist automations delete rule_123
|
|
461
|
-
arcanist automations delete rule_123 --yes --json
|
|
462
|
-
```
|
|
463
|
-
|
|
464
390
|
### `arcanist tokens list`
|
|
465
391
|
|
|
466
392
|
```bash
|