@tryarcanist/cli 0.1.136 → 0.1.138

package/README.md

@@ -52,7 +52,7 @@ Supported environment variables:
 
 ```bash
 export ARCANIST_TOKEN=arc_...
-export ARCANIST_API_URL=https://app.tryarcanist.com
+export ARCANIST_API_URL=https://api.tryarcanist.com
 ```
 
 `--token` and `--api-url` are available for one-off invocations. Prefer `ARCANIST_TOKEN` over `--token` for persistent use; CLI flags can appear in shell history and process lists.
@@ -64,7 +64,7 @@ Non-local API URLs must use HTTPS and must not embed credentials.
 ```bash
 arcanist --json
 arcanist --quiet
-arcanist --api-url https://app.tryarcanist.com
+arcanist --api-url https://api.tryarcanist.com
 arcanist --token arc_...
 arcanist --no-color
 ```
@@ -100,7 +100,7 @@ Mutation commands send an `Idempotency-Key` header. The CLI does not auto-retry
 ```bash
 arcanist auth login
 printf "arc_..." | arcanist auth login --token-stdin
-arcanist auth login --api-url https://app.tryarcanist.com
+arcanist auth login --api-url https://api.tryarcanist.com
 ```
 
 ### `arcanist auth whoami`
@@ -118,6 +118,7 @@ Creates a new session and sends the initial prompt.
 
 ```bash
 arcanist sessions create https://github.com/your-org/your-repo "fix the login bug"
+arcanist sessions create your-org/your-repo "continue this work" --start-branch wip/resume-me
 printf "add tests" | arcanist sessions create your-org/your-repo --prompt-stdin --json
 printf "add tests" | arcanist sessions create your-org/your-repo --prompt-stdin --wait
 arcanist sessions create your-org/your-repo - --model gpt-5.5
@@ -135,6 +136,8 @@ arcanist sessions create your-org/your-repo "retry-safe create" --idempotency-ke
 
 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.
 
+Use `--start-branch <branch>` to resume an existing branch with its history instead of forking a fresh branch off base; the control plane verifies the branch exists on the remote and fails closed if it does not.
+
 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.

package/dist/index.js

@@ -2592,6 +2592,10 @@ async function createCommand(repoUrl, promptArg, options, command) {
   if (options.baseBranch !== void 0 && !baseBranch) {
     throw new CliError("user", "--base-branch must not be empty.");
   }
+  const startBranch = options.startBranch?.trim();
+  if (options.startBranch !== void 0 && !startBranch) {
+    throw new CliError("user", "--start-branch must not be empty.");
+  }
   const uploadedFiles = await resolveUploadedFileOptions(options.uploadedFile);
   const idempotencyKey = options.idempotencyKey ?? randomIdempotencyKey();
   const sessionIdempotencyKey = `${idempotencyKey}:session`;
@@ -2601,6 +2605,7 @@ async function createCommand(repoUrl, promptArg, options, command) {
   if (options.backend) body.agentRuntimeBackend = agentRuntimeBackend;
   if (options.reasoningEffort) body.reasoningEffort = options.reasoningEffort;
   if (baseBranch) body.baseBranch = baseBranch;
+  if (startBranch) body.startBranch = startBranch;
   if (options.cold) body.cold = true;
   if (options.onboarding) body.onboarding = true;
   const sessionData = await apiFetch(config, "/api/sessions", {
@@ -2656,6 +2661,7 @@ async function createCommand(repoUrl, promptArg, options, command) {
     if (options.backend) output.agentRuntimeBackend = agentRuntimeBackend;
     if (options.reasoningEffort) output.reasoningEffort = options.reasoningEffort;
     if (baseBranch) output.baseBranch = baseBranch;
+    if (startBranch) output.startBranch = startBranch;
     if (options.onboarding) output.onboarding = true;
     if (promptId) output.promptId = promptId;
     writeJson(output);
@@ -4329,7 +4335,10 @@ 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("--base-branch <branch>", "Base branch to create the session against (defaults to the repo default branch)").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(
+    "--start-branch <branch>",
+    "Resume an existing branch with its history instead of forking a new one off base"
+  ).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.136",
+  "version": "0.1.138",
   "description": "CLI for Arcanist — create and manage coding agent sessions",
   "type": "module",
   "bin": {