@tryarcanist/cli 0.1.131 → 0.1.132

package/README.md

@@ -123,6 +123,7 @@ printf "add tests" | arcanist sessions create your-org/your-repo --prompt-stdin
 arcanist sessions create your-org/your-repo - --model gpt-5.5
 arcanist sessions create your-org/your-repo "port to claude" --backend claude_code --model claude-opus-4-8
 arcanist sessions create your-org/your-repo "refactor auth" --reasoning-effort xhigh
+arcanist sessions create your-org/your-repo "fix release branch" --base-branch release/2026-06
 arcanist sessions create your-org/your-repo "review the trace" --uploaded-file trace.txt
 arcanist sessions create your-org/your-repo "verify the deployed change" --cold
 arcanist sessions create your-org/your-repo "retry-safe create" --idempotency-key 1f0e6f1a-...
@@ -132,6 +133,8 @@ arcanist sessions create your-org/your-repo "retry-safe create" --idempotency-ke
 
 `--wait` blocks until the created prompt finishes and exits non-zero if the prompt finishes with `status: failed`, making it suitable for cron or other schedulers that alert on command failure. `--poll-interval <ms>` tunes the completion check frequency.
 
+Use `--base-branch <branch>` to target a non-default base branch. The CLI only validates that the branch value is non-empty; branch existence is checked later by the session runtime.
+
 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.
 
 `--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.
@@ -140,7 +143,7 @@ Repeatable `--uploaded-file <path>` flags attach local UTF-8 text files to the p
 
 `--onboarding` creates an onboarding session: the agent authors the repo's `.arcanist.json`, `.arcanist/` runtime files, `ARCANIST.md`, and conditionally `.arcanist/sandbox.yaml` + `.arcanist/sandbox.layer.Dockerfile` (when the base sandbox lacks a needed toolchain), proves what it can inside its sandbox, and opens the setup PR ready for review. Team use; not part of the external API surface.
 
-JSON mode returns `{sessionId, sessionUrl?, repoUrl, model?, agentRuntimeBackend?, reasoningEffort?, promptId?}`. `sessionUrl` is emitted only when the server returns it; `agentRuntimeBackend` only when `--backend` is passed.
+JSON mode returns `{sessionId, sessionUrl?, repoUrl, model?, agentRuntimeBackend?, reasoningEffort?, baseBranch?, promptId?}`. `sessionUrl` is emitted only when the server returns it; `agentRuntimeBackend` only when `--backend` is passed.
 
 ### `arcanist sessions send <session-id> [prompt]`
 

package/dist/index.js

@@ -2571,6 +2571,10 @@ async function createCommand(repoUrl, promptArg, options, command) {
   if (repoError) {
     throw new CliError("user", repoError);
   }
+  const baseBranch = options.baseBranch?.trim();
+  if (options.baseBranch !== void 0 && !baseBranch) {
+    throw new CliError("user", "--base-branch must not be empty.");
+  }
   const uploadedFiles = await resolveUploadedFileOptions(options.uploadedFile);
   const idempotencyKey = options.idempotencyKey ?? randomIdempotencyKey();
   const sessionIdempotencyKey = `${idempotencyKey}:session`;
@@ -2579,6 +2583,7 @@ async function createCommand(repoUrl, promptArg, options, command) {
   if (options.model) body.model = options.model;
   if (options.backend) body.agentRuntimeBackend = agentRuntimeBackend;
   if (options.reasoningEffort) body.reasoningEffort = options.reasoningEffort;
+  if (baseBranch) body.baseBranch = baseBranch;
   if (options.cold) body.cold = true;
   if (options.onboarding) body.onboarding = true;
   const sessionData = await apiFetch(config, "/api/sessions", {
@@ -2624,6 +2629,7 @@ async function createCommand(repoUrl, promptArg, options, command) {
     if (options.model) output.model = options.model;
     if (options.backend) output.agentRuntimeBackend = agentRuntimeBackend;
     if (options.reasoningEffort) output.reasoningEffort = options.reasoningEffort;
+    if (baseBranch) output.baseBranch = baseBranch;
     if (options.onboarding) output.onboarding = true;
     if (promptId) output.promptId = promptId;
     writeJson(output);
@@ -4146,7 +4152,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) or claude_code").option("--reasoning-effort <effort>", "Reasoning effort to use for models that support it").option("--prompt-stdin", "Read prompt from stdin").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: codex (default) or claude_code").option("--reasoning-effort <effort>", "Reasoning effort to use for models that support it").option("--base-branch <branch>", "Base branch to create the session against (defaults to the repo default branch)").option("--prompt-stdin", "Read prompt from stdin").option(
     "--uploaded-file <path>",
     "Attach a local text file to the prompt as uploadedFiles; repeat for multiple files",
     collectUploadedFileOption

package/package.json

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