@tryarcanist/cli 0.1.225 → 0.1.226

package/README.md

@@ -197,7 +197,7 @@ arcanist sessions create your-org/your-repo "review the trace" --uploaded-file t
 arcanist sessions create your-org/your-repo "retry-safe create" --idempotency-key 1f0e6f1a-...
 ```
 
-`--backend` picks the agent runtime backend: `codex` (default) or `claude_code`. `--model` must be valid for the chosen backend — codex runs OpenAI models (`gpt-5.4` default, `gpt-5.5`), `claude_code` runs Anthropic models (`claude-opus-4-8` default, `claude-sonnet-4-6`, `claude-fable-5`) — and the CLI rejects a mismatch before any network call. `claude_code` sessions require an Anthropic API key configured in Settings.
+`--backend` picks the agent runtime backend: `codex` (default), `claude_code`, `opencode`, `cursor`, or `grok`. `--model` must be valid for the chosen backend and the CLI rejects a mismatch before any network call; run `arcanist models list` for the selectable models per backend. When `--model` is omitted the backend default is used. Non-codex backends require the matching provider credential configured in Settings.
 
 `--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.
 
@@ -242,7 +242,7 @@ The PR URL must be `https://github.com/<owner>/<repo>/pull/<number>`.
 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`).
 Inspect progress with the session URL or the session events stream.
 
-`--backend` picks the agent runtime backend: `codex` (default), `claude_code`, or `opencode`.
+`--backend` picks the agent runtime backend: `codex` (default), `claude_code`, `opencode`, `cursor`, or `grok`.
 `--model` must be valid for the chosen backend, and the CLI rejects mismatches before any network call.
 When `--model` is omitted, the backend default is used.
 

package/dist/index.js

@@ -4,6 +4,31 @@
 import { createRequire as createRequire2 } from "module";
 import { Command } from "commander";
 
+// ../../shared/agent/agent-runtime-backend.ts
+var CODEX_AGENT_RUNTIME_BACKEND = "codex";
+var CLAUDE_CODE_AGENT_RUNTIME_BACKEND = "claude_code";
+var OPENCODE_AGENT_RUNTIME_BACKEND = "opencode";
+var CURSOR_AGENT_RUNTIME_BACKEND = "cursor";
+var GROK_AGENT_RUNTIME_BACKEND = "grok";
+var AGENT_RUNTIME_BACKENDS = [
+  CODEX_AGENT_RUNTIME_BACKEND,
+  CLAUDE_CODE_AGENT_RUNTIME_BACKEND,
+  OPENCODE_AGENT_RUNTIME_BACKEND,
+  CURSOR_AGENT_RUNTIME_BACKEND,
+  GROK_AGENT_RUNTIME_BACKEND
+];
+var AGENT_RUNTIME_BACKEND_NAMES = {
+  [CODEX_AGENT_RUNTIME_BACKEND]: "Codex",
+  [CLAUDE_CODE_AGENT_RUNTIME_BACKEND]: "Claude Code",
+  // "opencode" is intentionally lowercase to match the project's brand name.
+  [OPENCODE_AGENT_RUNTIME_BACKEND]: "opencode",
+  [CURSOR_AGENT_RUNTIME_BACKEND]: "Cursor",
+  [GROK_AGENT_RUNTIME_BACKEND]: "Grok Build"
+};
+function isAgentRuntimeBackend(value) {
+  return AGENT_RUNTIME_BACKENDS.includes(value);
+}
+
 // src/commands/agent-subscription.ts
 import { execFileSync, spawn as spawn2 } from "child_process";
 import { existsSync as existsSync2 } from "fs";
@@ -1138,29 +1163,61 @@ async function whoamiCommand(options, command) {
   });
 }
 
-// ../../shared/agent/agent-runtime-backend.ts
-var CODEX_AGENT_RUNTIME_BACKEND = "codex";
-var CLAUDE_CODE_AGENT_RUNTIME_BACKEND = "claude_code";
-var OPENCODE_AGENT_RUNTIME_BACKEND = "opencode";
-var CURSOR_AGENT_RUNTIME_BACKEND = "cursor";
-var GROK_AGENT_RUNTIME_BACKEND = "grok";
-var AGENT_RUNTIME_BACKENDS = [
-  CODEX_AGENT_RUNTIME_BACKEND,
-  CLAUDE_CODE_AGENT_RUNTIME_BACKEND,
-  OPENCODE_AGENT_RUNTIME_BACKEND,
-  CURSOR_AGENT_RUNTIME_BACKEND,
-  GROK_AGENT_RUNTIME_BACKEND
-];
-var AGENT_RUNTIME_BACKEND_NAMES = {
-  [CODEX_AGENT_RUNTIME_BACKEND]: "Codex",
-  [CLAUDE_CODE_AGENT_RUNTIME_BACKEND]: "Claude Code",
-  // "opencode" is intentionally lowercase to match the project's brand name.
-  [OPENCODE_AGENT_RUNTIME_BACKEND]: "opencode",
-  [CURSOR_AGENT_RUNTIME_BACKEND]: "Cursor",
-  [GROK_AGENT_RUNTIME_BACKEND]: "Grok Build"
-};
-function isAgentRuntimeBackend(value) {
-  return AGENT_RUNTIME_BACKENDS.includes(value);
+// src/utils/pagination.ts
+var MAX_ALL_PAGES = 1e3;
+async function fetchPages(label, all, initialCursor, fetchPage) {
+  const items = [];
+  let cursor2 = initialCursor;
+  let nextCursor = null;
+  let pageCount = 0;
+  do {
+    pageCount += 1;
+    if (all && pageCount > MAX_ALL_PAGES) {
+      throw new CliError("user", `${label} exceeded ${MAX_ALL_PAGES} pages without reaching the end.`);
+    }
+    const page = await fetchPage(cursor2);
+    items.push(...page.items);
+    nextCursor = page.nextCursor;
+    cursor2 = nextCursor ?? void 0;
+  } while (all && nextCursor);
+  return { items, nextCursor: all ? null : nextCursor };
+}
+
+// ../../shared/github/repo-url.ts
+function parseGithubRepoFullName(value) {
+  const shorthand = value.match(/^([a-zA-Z0-9_.-]+)\/([a-zA-Z0-9_.-]+)$/);
+  if (shorthand) return { owner: shorthand[1], repo: shorthand[2] };
+  const ssh = value.match(/^git@github\.com:([^/]+)\/([^/]+?)(?:\.git)?$/);
+  if (ssh) return { owner: ssh[1], repo: ssh[2] };
+  const https = value.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?\/?$/);
+  if (https) return { owner: https[1], repo: https[2] };
+  return null;
+}
+
+// src/git.ts
+import { execFileSync as execFileSync2 } from "child_process";
+function git(args) {
+  try {
+    return execFileSync2("git", args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
+  } catch (err) {
+    throw new CliError("user", `git ${args.join(" ")} failed: ${stringifyError(err)}`);
+  }
+}
+function currentRepo() {
+  const parsed = parseGithubRepoFullName(git(["remote", "get-url", "origin"]));
+  if (!parsed) throw new CliError("user", "origin remote must point at a GitHub repository");
+  return { owner: parsed.owner, repo: parsed.repo };
+}
+
+// src/utils/repo-arg.ts
+function parseRepoArg(value, argName = "repo") {
+  const parsed = parseGithubRepoFullName(value);
+  if (!parsed) throw new CliError("user", `${argName} must be owner/name or a GitHub URL`);
+  return { owner: parsed.owner, repo: parsed.repo.replace(/\.git$/, "") };
+}
+function parseRepoArgOrCurrent(value, argName = "repo") {
+  if (value === void 0) return currentRepo();
+  return parseRepoArg(value, argName);
 }
 
 // ../../shared/utils/type-guards.ts
@@ -1909,61 +1966,40 @@ var SESSION_START_MODEL_PROVIDER_GROUPS_BY_SUBSCRIPTIONS = {
   "true:true": buildSubscriptionAwareGroups({ codexSubscription: true, grokSubscription: true })
 };
 
-// src/utils/pagination.ts
-var MAX_ALL_PAGES = 1e3;
-async function fetchPages(label, all, initialCursor, fetchPage) {
-  const items = [];
-  let cursor2 = initialCursor;
-  let nextCursor = null;
-  let pageCount = 0;
-  do {
-    pageCount += 1;
-    if (all && pageCount > MAX_ALL_PAGES) {
-      throw new CliError("user", `${label} exceeded ${MAX_ALL_PAGES} pages without reaching the end.`);
-    }
-    const page = await fetchPage(cursor2);
-    items.push(...page.items);
-    nextCursor = page.nextCursor;
-    cursor2 = nextCursor ?? void 0;
-  } while (all && nextCursor);
-  return { items, nextCursor: all ? null : nextCursor };
-}
-
-// ../../shared/github/repo-url.ts
-function parseGithubRepoFullName(value) {
-  const shorthand = value.match(/^([a-zA-Z0-9_.-]+)\/([a-zA-Z0-9_.-]+)$/);
-  if (shorthand) return { owner: shorthand[1], repo: shorthand[2] };
-  const ssh = value.match(/^git@github\.com:([^/]+)\/([^/]+?)(?:\.git)?$/);
-  if (ssh) return { owner: ssh[1], repo: ssh[2] };
-  const https = value.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?\/?$/);
-  if (https) return { owner: https[1], repo: https[2] };
-  return null;
+// src/commands/model-options.ts
+function backendForProviderPrefix(rawModel) {
+  const provider = rawModel.match(/^([a-z]+)[/:]/i)?.[1]?.toLowerCase();
+  if (provider === "anthropic") return CLAUDE_CODE_AGENT_RUNTIME_BACKEND;
+  if (provider === "baseten" || provider === "xai") return OPENCODE_AGENT_RUNTIME_BACKEND;
+  if (provider === "cursor") return CURSOR_AGENT_RUNTIME_BACKEND;
+  if (provider === "grok") return GROK_AGENT_RUNTIME_BACKEND;
+  return void 0;
 }
-
-// src/git.ts
-import { execFileSync as execFileSync2 } from "child_process";
-function git(args) {
-  try {
-    return execFileSync2("git", args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
-  } catch (err) {
-    throw new CliError("user", `git ${args.join(" ")} failed: ${stringifyError(err)}`);
+function resolveModelAndBackend(options) {
+  let agentRuntimeBackend = CODEX_AGENT_RUNTIME_BACKEND;
+  const normalizedModel = options.model !== void 0 ? extractModelId(options.model) : void 0;
+  if (options.backend !== void 0) {
+    if (!isAgentRuntimeBackend(options.backend)) {
+      throw new CliError(
+        "user",
+        `Invalid --backend '${options.backend}'. Expected ${AGENT_RUNTIME_BACKENDS.join(", ")}.`
+      );
+    }
+    agentRuntimeBackend = options.backend;
+  } else if (options.model !== void 0) {
+    const derived = (normalizedModel ? getAgentRuntimeBackendForModel(normalizedModel) : void 0) ?? backendForProviderPrefix(options.model);
+    if (derived) agentRuntimeBackend = derived;
   }
-}
-function currentRepo() {
-  const parsed = parseGithubRepoFullName(git(["remote", "get-url", "origin"]));
-  if (!parsed) throw new CliError("user", "origin remote must point at a GitHub repository");
-  return { owner: parsed.owner, repo: parsed.repo };
-}
-
-// src/utils/repo-arg.ts
-function parseRepoArg(value, argName = "repo") {
-  const parsed = parseGithubRepoFullName(value);
-  if (!parsed) throw new CliError("user", `${argName} must be owner/name or a GitHub URL`);
-  return { owner: parsed.owner, repo: parsed.repo.replace(/\.git$/, "") };
-}
-function parseRepoArgOrCurrent(value, argName = "repo") {
-  if (value === void 0) return currentRepo();
-  return parseRepoArg(value, argName);
+  if (options.model !== void 0) {
+    if (normalizedModel === void 0 || !isSessionStartModelAllowedForBackend(normalizedModel, agentRuntimeBackend)) {
+      const allowed = getSessionStartModelIdsForBackend(agentRuntimeBackend).join(", ");
+      throw new CliError(
+        "user",
+        `Model '${options.model}' is not selectable for backend '${agentRuntimeBackend}'. Allowed: ${allowed}.`
+      );
+    }
+  }
+  return { agentRuntimeBackend, modelId: normalizedModel };
 }
 
 // src/commands/automations.ts
@@ -1996,15 +2032,7 @@ async function createAutomationCommand(repoUrl, promptArg, options, command) {
   }
   const runtime = getRuntimeOptions(command, options);
   const config = requireConfig(runtime);
-  let normalizedModel;
-  if (options.model !== void 0) {
-    normalizedModel = extractModelId(options.model);
-    const backend = resolveAutomationModelBackend(options.model, normalizedModel);
-    if (normalizedModel === void 0 || !isSessionStartModelAllowedForBackend(normalizedModel, backend)) {
-      const allowed = getSessionStartModelIdsForBackend(backend).join(", ");
-      throw new CliError("user", `Model '${options.model}' is not selectable. Allowed: ${allowed}.`);
-    }
-  }
+  const { modelId: normalizedModel } = resolveModelAndBackend(options);
   const body = {
     repoOwner: repo.owner,
     repoName: repo.repo,
@@ -2077,18 +2105,6 @@ async function deleteAutomationCommand(id, options, command) {
   }
   console.log(`Deleted automation ${id}.`);
 }
-function resolveAutomationModelBackend(rawModel, normalizedModel) {
-  if (normalizedModel) {
-    const backend = getAgentRuntimeBackendForModel(normalizedModel);
-    if (backend) return backend;
-  }
-  const provider = rawModel.match(/^([a-z]+)[/:]/i)?.[1]?.toLowerCase();
-  if (provider === "anthropic") return CLAUDE_CODE_AGENT_RUNTIME_BACKEND;
-  if (provider === "baseten" || provider === "xai") return OPENCODE_AGENT_RUNTIME_BACKEND;
-  if (provider === "cursor") return CURSOR_AGENT_RUNTIME_BACKEND;
-  if (provider === "grok") return GROK_AGENT_RUNTIME_BACKEND;
-  return CODEX_AGENT_RUNTIME_BACKEND;
-}
 async function automationApiFetch(config, path, init) {
   try {
     return await apiFetch(config, path, init);
@@ -3842,35 +3858,6 @@ function unwrapSessionState(payload) {
   return payload.session && typeof payload.session === "object" ? payload.session : payload;
 }
 
-// src/commands/model-options.ts
-function resolveModelAndBackend(options) {
-  let agentRuntimeBackend = CODEX_AGENT_RUNTIME_BACKEND;
-  if (options.backend !== void 0) {
-    if (!isAgentRuntimeBackend(options.backend)) {
-      throw new CliError(
-        "user",
-        `Invalid --backend '${options.backend}'. Expected ${AGENT_RUNTIME_BACKENDS.join(", ")}.`
-      );
-    }
-    agentRuntimeBackend = options.backend;
-  } else if (options.model !== void 0) {
-    const normalizedModel = extractModelId(options.model);
-    const derived = normalizedModel ? getAgentRuntimeBackendForModel(normalizedModel) : void 0;
-    if (derived) agentRuntimeBackend = derived;
-  }
-  if (options.model !== void 0) {
-    const normalizedModel = extractModelId(options.model);
-    if (normalizedModel === void 0 || !isSessionStartModelAllowedForBackend(normalizedModel, agentRuntimeBackend)) {
-      const allowed = getSessionStartModelIdsForBackend(agentRuntimeBackend).join(", ");
-      throw new CliError(
-        "user",
-        `Model '${options.model}' is not selectable for backend '${agentRuntimeBackend}'. Allowed: ${allowed}.`
-      );
-    }
-  }
-  return agentRuntimeBackend;
-}
-
 // ../../shared/session/transient-disconnect.ts
 var TRANSIENT_DISCONNECT_VISIBILITY_MS = 15e3;
 function nextDisconnectMask(mask, previous, current, now) {
@@ -4137,7 +4124,7 @@ async function createCommand(repoUrl, promptArg, options, command) {
   const runtime = getRuntimeOptions(command, options);
   assertArcanistSessionMutationAllowed("create");
   const config = requireConfig(runtime);
-  const agentRuntimeBackend = resolveModelAndBackend(options);
+  const { agentRuntimeBackend } = resolveModelAndBackend(options);
   const prompt = options.onboarding ? ONBOARDING_PROMPT : await resolvePromptInput(promptArg, options);
   const waitPollIntervalMs = options.wait ? parsePollInterval(options.pollInterval) : null;
   const repoError = validateRepoUrl(repoUrl);
@@ -4563,7 +4550,7 @@ async function qaCommand(prUrl, options, command) {
   assertArcanistSessionMutationAllowed("qa");
   const config = requireConfig(runtime);
   const { targetPrUrl, repoUrl } = parseCanonicalPrUrl(prUrl);
-  const agentRuntimeBackend = resolveModelAndBackend(options);
+  const { agentRuntimeBackend } = resolveModelAndBackend(options);
   const idempotencyKey = options.idempotencyKey ?? randomIdempotencyKey();
   const sessionIdempotencyKey = `${idempotencyKey}:session`;
   const promptIdempotencyKey = `${idempotencyKey}:prompt`;
@@ -6226,7 +6213,7 @@ program.hook("preAction", (_thisCommand, actionCommand) => {
   applyColorEnvironment(getRuntimeOptions(actionCommand));
 });
 function addCreateOptions(cmd) {
-  return cmd.argument("<repo-url>", "Repository URL").argument("[prompt]", "Prompt to send, or '-' to read stdin").option("--model <model>", "Model to use").option("--backend <backend>", "Agent runtime backend: codex (default), claude_code, or opencode").option("--reasoning-effort <effort>", "Reasoning effort to use for models that support it").option("--auto-verify", "Opt this session into automatic QA verification after PR creation").option("--base-branch <branch>", "Base branch to create the session against (defaults to the repo default branch)").option(
+  return cmd.argument("<repo-url>", "Repository URL").argument("[prompt]", "Prompt to send, or '-' to read stdin").option("--model <model>", "Model to use").option("--backend <backend>", `Agent runtime backend: ${AGENT_RUNTIME_BACKENDS.join(", ")} (default codex)`).option("--reasoning-effort <effort>", "Reasoning effort to use for models that support it").option("--auto-verify", "Opt this session into automatic QA verification after PR creation").option("--base-branch <branch>", "Base branch to create the session against (defaults to the repo default branch)").option(
     "--start-branch <branch>",
     "Resume an existing branch with its history instead of forking a new one off base"
   ).option("--linear-issue <id|url>", "Associate the session with a Linear issue for pickup writeback").option("--jira-issue <key|url>", "Associate the session with a Jira issue for pickup writeback").option("--continue-pr <url>", "Continue from an existing same-repo pull request").option("--continue-mode <mode>", "Continuation mode: auto (default), update-pr, or new-pr").option("--prompt-stdin", "Read prompt from stdin").option(
@@ -6276,7 +6263,7 @@ JSON mode returns {sessionId, promptId?}
   );
 }
 function addQaOptions(cmd) {
-  return cmd.argument("<pr-url>", "GitHub pull request URL to QA").option("--model <model>", "Model to use").option("--backend <backend>", "Agent runtime backend: codex (default), claude_code, or opencode").option("--reasoning-effort <effort>", "Reasoning effort to use for models that support it").option("--wait", "Wait for the QA prompt to finish and exit non-zero if it fails").option(
+  return cmd.argument("<pr-url>", "GitHub pull request URL to QA").option("--model <model>", "Model to use").option("--backend <backend>", `Agent runtime backend: ${AGENT_RUNTIME_BACKENDS.join(", ")} (default codex)`).option("--reasoning-effort <effort>", "Reasoning effort to use for models that support it").option("--wait", "Wait for the QA prompt to finish and exit non-zero if it fails").option(
     "--poll-interval <ms>",
     "Polling interval in milliseconds while waiting",
     String(DEFAULT_WATCH_POLL_INTERVAL_MS)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryarcanist/cli",
-  "version": "0.1.225",
+  "version": "0.1.226",
   "description": "CLI for Arcanist — create and manage coding agent sessions",
   "type": "module",
   "bin": {