@tryarcanist/cli 0.1.224 → 0.1.225
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 -28
- package/dist/index.js +1 -25
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -194,7 +194,6 @@ arcanist sessions create your-org/your-repo "refactor auth" --reasoning-effort x
|
|
|
194
194
|
arcanist sessions create your-org/your-repo "verify this automatically" --auto-verify
|
|
195
195
|
arcanist sessions create your-org/your-repo "fix release branch" --base-branch release/2026-06
|
|
196
196
|
arcanist sessions create your-org/your-repo "review the trace" --uploaded-file trace.txt
|
|
197
|
-
arcanist sessions create your-org/your-repo "verify the deployed change" --cold
|
|
198
197
|
arcanist sessions create your-org/your-repo "retry-safe create" --idempotency-key 1f0e6f1a-...
|
|
199
198
|
```
|
|
200
199
|
|
|
@@ -217,7 +216,7 @@ The CLI echoes the request value as `jiraIssue` in JSON output; pickup writeback
|
|
|
217
216
|
|
|
218
217
|
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.
|
|
219
218
|
|
|
220
|
-
|
|
219
|
+
Sessions always start from a fresh sandbox (the warm sandbox pool was removed).
|
|
221
220
|
|
|
222
221
|
`--idempotency-key <uuid>` is for manually retrying a create request that may have reached the server.
|
|
223
222
|
The CLI derives separate session and prompt idempotency keys from the provided value.
|
|
@@ -322,17 +321,6 @@ JSON mode returns `{sessions, nextCursor}`.
|
|
|
322
321
|
`--all` follows cursors until completion and returns `nextCursor: null`.
|
|
323
322
|
Search is metadata-only: generated titles and repo metadata.
|
|
324
323
|
|
|
325
|
-
### `arcanist sessions search <query>`
|
|
326
|
-
|
|
327
|
-
```bash
|
|
328
|
-
arcanist sessions search "architect agent"
|
|
329
|
-
arcanist sessions search "mcp debugging" --repo your-org/your-repo --json
|
|
330
|
-
arcanist sessions search "repo access" --status idle --scope business --limit 20 --cursor <cursor>
|
|
331
|
-
arcanist sessions search "repo access" --all --json
|
|
332
|
-
```
|
|
333
|
-
|
|
334
|
-
Uses the same metadata-only index and filters as `sessions list`: `--status`, `--scope`, `--repo`, `--limit`, `--cursor`, and `--all`.
|
|
335
|
-
|
|
336
324
|
### `arcanist sessions events <session-id>`
|
|
337
325
|
|
|
338
326
|
Reads canonical session replay events. Cursors are sequence-based.
|
|
@@ -367,15 +355,6 @@ arcanist sessions transcript abc123 --last 20
|
|
|
367
355
|
|
|
368
356
|
`--last <n>` renders only the last `n` stored transcript events after fetching the session export.
|
|
369
357
|
|
|
370
|
-
### `arcanist sessions watch <session-id>`
|
|
371
|
-
|
|
372
|
-
Watches session activity until the session becomes idle. For machine-readable streaming, prefer `arcanist sessions events --follow --json`.
|
|
373
|
-
|
|
374
|
-
```bash
|
|
375
|
-
arcanist sessions watch abc123
|
|
376
|
-
arcanist sessions watch abc123 --poll-interval 500
|
|
377
|
-
```
|
|
378
|
-
|
|
379
358
|
### `arcanist sessions usage <session-id>`
|
|
380
359
|
|
|
381
360
|
```bash
|
|
@@ -510,12 +489,6 @@ SESSION_ID=$(arcanist sessions create your-org/your-repo "audit dependency licen
|
|
|
510
489
|
arcanist sessions events "$SESSION_ID" --follow --json | jq -r 'select(.type == "assistant_message")'
|
|
511
490
|
```
|
|
512
491
|
|
|
513
|
-
Verify a freshly deployed change with a guaranteed-fresh sandbox:
|
|
514
|
-
|
|
515
|
-
```bash
|
|
516
|
-
arcanist sessions create your-org/your-repo "verify the new rate limiter is active" --cold --wait
|
|
517
|
-
```
|
|
518
|
-
|
|
519
492
|
For cron, prefer `ARCANIST_TOKEN` or a logged-in `~/.arcanist/config.json` over passing `--token` on the command line.
|
|
520
493
|
|
|
521
494
|
To capture the PR URL after a successful run, read the best-effort result fields from `create --wait --json`:
|
package/dist/index.js
CHANGED
|
@@ -4185,7 +4185,6 @@ async function createCommand(repoUrl, promptArg, options, command) {
|
|
|
4185
4185
|
if (jiraIssue) body.jiraIssue = jiraIssue;
|
|
4186
4186
|
if (continuePr) body.continuePrUrl = continuePr;
|
|
4187
4187
|
if (continueMode) body.continueMode = continueMode;
|
|
4188
|
-
if (options.cold) body.cold = true;
|
|
4189
4188
|
if (options.onboarding) body.onboarding = true;
|
|
4190
4189
|
const sessionData = await apiFetch(config, "/api/sessions", {
|
|
4191
4190
|
method: "POST",
|
|
@@ -5884,9 +5883,6 @@ async function listSessionsCommand(options, command) {
|
|
|
5884
5883
|
}
|
|
5885
5884
|
if (payload.nextCursor) console.log(`Next cursor: ${payload.nextCursor}`);
|
|
5886
5885
|
}
|
|
5887
|
-
async function searchSessionsCommand(query, options, command) {
|
|
5888
|
-
await listSessionsCommand({ ...options, search: query }, command);
|
|
5889
|
-
}
|
|
5890
5886
|
async function getSessionCommand(sessionId, options, command) {
|
|
5891
5887
|
const runtime = getRuntimeOptions(command, options);
|
|
5892
5888
|
const config = requireConfig(runtime);
|
|
@@ -6241,7 +6237,7 @@ function addCreateOptions(cmd) {
|
|
|
6241
6237
|
"--poll-interval <ms>",
|
|
6242
6238
|
"Polling interval in milliseconds while waiting",
|
|
6243
6239
|
String(DEFAULT_WATCH_POLL_INTERVAL_MS)
|
|
6244
|
-
).option("--idempotency-key <uuid>", "Request idempotency key for safe manual retries").option("--
|
|
6240
|
+
).option("--idempotency-key <uuid>", "Request idempotency key for safe manual retries").option("--onboarding", "Create an onboarding session that authors the repo's Arcanist configuration").addHelpText(
|
|
6245
6241
|
"after",
|
|
6246
6242
|
`
|
|
6247
6243
|
Examples:
|
|
@@ -6468,18 +6464,6 @@ JSON:
|
|
|
6468
6464
|
JSON mode returns {sessions, nextCursor}. --all follows cursors until nextCursor is null.
|
|
6469
6465
|
`
|
|
6470
6466
|
).action((options, command) => listSessionsCommand(options, command));
|
|
6471
|
-
sessions.command("search").description("Search sessions by title and repo metadata").argument("<query>", "Search query").option("--status <status>", "Filter by session status").option("--scope <scope>", "Session scope: mine or business").option("--repo <repo>", "Filter by repo metadata").option("--limit <n>", "Maximum sessions to return").option("--cursor <cursor>", "Pagination cursor").option("--all", "Fetch all pages").addHelpText(
|
|
6472
|
-
"after",
|
|
6473
|
-
`
|
|
6474
|
-
Examples:
|
|
6475
|
-
arcanist sessions search "architect agent"
|
|
6476
|
-
arcanist sessions search "mcp debugging" --repo owner/repo --json
|
|
6477
|
-
arcanist sessions search "repo access" --all --json
|
|
6478
|
-
|
|
6479
|
-
JSON:
|
|
6480
|
-
JSON mode returns {sessions, nextCursor}. --all follows cursors until nextCursor is null.
|
|
6481
|
-
`
|
|
6482
|
-
).action((query, options, command) => searchSessionsCommand(query, options, command));
|
|
6483
6467
|
sessions.command("events").description("Read or follow session replay events").argument("<session-id>", "Session ID").option("--after-sequence <n>", "Return events after this sequence").option("--after <n>", "Alias for --after-sequence").option("--before-sequence <n>", "Return events before this sequence").option("--before <n>", "Alias for --before-sequence").option("--prompt-id <id>", "Filter events by prompt ID").option("--limit <n>", "Maximum events to return").option("--follow", "Follow events until the session is idle").option("--poll-interval <ms>", "Polling interval in milliseconds", String(DEFAULT_WATCH_POLL_INTERVAL_MS)).addHelpText(
|
|
6484
6468
|
"after",
|
|
6485
6469
|
`
|
|
@@ -6504,14 +6488,6 @@ Examples:
|
|
|
6504
6488
|
arcanist sessions transcript <session-id> --last 20
|
|
6505
6489
|
`
|
|
6506
6490
|
).action((sessionId, options, command) => transcriptCommand(sessionId, options, command));
|
|
6507
|
-
sessions.command("watch").description("Watch session activity until it becomes idle").argument("<session-id>", "Session ID").option("--poll-interval <ms>", "Polling interval in milliseconds", String(DEFAULT_WATCH_POLL_INTERVAL_MS)).addHelpText(
|
|
6508
|
-
"after",
|
|
6509
|
-
`
|
|
6510
|
-
Examples:
|
|
6511
|
-
arcanist sessions watch <session-id>
|
|
6512
|
-
arcanist sessions watch <session-id> --json
|
|
6513
|
-
`
|
|
6514
|
-
).action((sessionId, options, command) => watchCommand(sessionId, options, command));
|
|
6515
6491
|
sessions.command("usage").description("Get token usage for a session").argument("<session-id>", "Session ID").addHelpText(
|
|
6516
6492
|
"after",
|
|
6517
6493
|
`
|