@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.
Files changed (3) hide show
  1. package/README.md +1 -28
  2. package/dist/index.js +1 -25
  3. 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
- `--cold` is a deprecated no-op retained for backward compatibility. Sessions always start from a fresh sandbox (the warm sandbox pool was removed), so the flag has no effect.
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("--cold", "Deprecated no-op; sessions always start from a fresh sandbox").option("--onboarding", "Create an onboarding session that authors the repo's Arcanist configuration").addHelpText(
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
  `
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tryarcanist/cli",
3
- "version": "0.1.224",
3
+ "version": "0.1.225",
4
4
  "description": "CLI for Arcanist — create and manage coding agent sessions",
5
5
  "type": "module",
6
6
  "bin": {