@tryarcanist/cli 0.1.201 → 0.1.202

package/README.md

@@ -15,6 +15,7 @@ Requires Node.js 22 or newer.
 ```bash
 arcanist auth login                 # paste a token from Settings > CLI Tokens
 arcanist sessions create https://github.com/your-org/your-repo "fix the login bug"
+arcanist sessions create https://github.com/your-org/your-repo "fix ARC-1635" --linear-issue https://linear.app/team/issue/ARC-1635/fix-login
 ```
 
 ```bash
@@ -208,6 +209,9 @@ Use `--start-branch <branch>` to resume an existing branch with its history inst
 
 Use `--continue-pr <url>` to continue an open same-repo pull request. The control plane checks out the PR head branch before the prompt runs. `--continue-mode update-pr` updates the referenced PR; `--continue-mode new-pr` starts from that PR head but leaves publish free to open a fresh PR. `auto` is the default and currently resolves to same-PR update for supported open same-repo PRs.
 
+Use `--linear-issue <id|url>` to attach a Linear issue reference to the created session.
+The CLI echoes the request value as `linearIssue` in JSON output; pickup writeback occurs after the first prompt is durably enqueued.
+
 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

@@ -3456,6 +3456,11 @@ async function createCommand(repoUrl, promptArg, options, command) {
   if (promptPreview) body.prompt = promptPreview;
   if (baseBranch) body.baseBranch = baseBranch;
   if (startBranch) body.startBranch = startBranch;
+  const linearIssue = options.linearIssue?.trim();
+  if (options.linearIssue !== void 0 && !linearIssue) {
+    throw new CliError("user", "--linear-issue must not be empty.");
+  }
+  if (linearIssue) body.linearIssue = linearIssue;
   if (continuePr) body.continuePrUrl = continuePr;
   if (continueMode) body.continueMode = continueMode;
   if (options.cold) body.cold = true;
@@ -3527,6 +3532,7 @@ async function createCommand(repoUrl, promptArg, options, command) {
     if (options.autoVerify) output.autoVerify = true;
     if (baseBranch) output.baseBranch = baseBranch;
     if (startBranch) output.startBranch = startBranch;
+    if (linearIssue) output.linearIssue = linearIssue;
     if (continuePr) output.continuePrUrl = continuePr;
     if (continueMode) output.continueMode = continueMode;
     if (options.onboarding) output.onboarding = true;
@@ -5517,7 +5523,7 @@ 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(
     "--start-branch <branch>",
     "Resume an existing branch with its history instead of forking a new one off base"
-  ).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(
+  ).option("--linear-issue <id|url>", "Associate the session with a Linear 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(
     "--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.201",
+  "version": "0.1.202",
   "description": "CLI for Arcanist — create and manage coding agent sessions",
   "type": "module",
   "bin": {