linear-sdk-cli 0.1.0 → 0.1.2

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "linear-sdk-cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Ergonomic command-line interface for Linear, built on @linear/sdk",
   "type": "module",
   "license": "MIT",
   "author": "Eugene Beloded <belodedevgenij@gmail.com>",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/zhendalf/linear-sdk-cli.git"
+    "url": "https://github.com/zhendalf/linear-sdk-cli"
   },
   "homepage": "https://github.com/zhendalf/linear-sdk-cli#readme",
   "bugs": {
@@ -55,31 +55,30 @@
     "typecheck": "tsc --noEmit",
     "lint": "eslint .",
     "format": "prettier --write .",
-    "format:check": "prettier --check .",
     "test": "bun test test/unit test/contract",
     "test:unit": "bun test test/unit",
     "test:contract": "bun test test/contract",
     "test:live": "LINEAR_CLI_LIVE=1 bun test --timeout 60000 test/integration",
     "test:live:admin": "LINEAR_CLI_LIVE=1 LINEAR_CLI_LIVE_ADMIN=1 bun test --timeout 60000 test/integration",
-    "verify": "bun run typecheck && bun run lint && bun run audit:coverage && bun run format:check && bun run test",
+    "verify": "bun run typecheck && bun run lint && bun run test",
     "skill:docs": "bun run skills/linear-sdk-cli/scripts/generate-docs.ts",
     "audit:coverage": "bun run scripts/coverage-audit.ts",
     "janitor": "bun run test/janitor.ts"
   },
   "dependencies": {
-    "@inquirer/prompts": "^8.5.2",
-    "@linear/sdk": "^89.0.0",
+    "@inquirer/prompts": "^8.6.0",
+    "@linear/sdk": "^91.0.0",
     "commander": "^15.0.0",
     "graphql": "^17.0.2",
     "picocolors": "^1.1.1",
     "smol-toml": "^1.8.0"
   },
-  "packageManager": "bun@1.3.14",
+  "packageManager": "bun@1.4.0",
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@types/bun": "^1.3.14",
+    "@types/bun": "^1.4.0",
     "@types/node": "^26.2.0",
-    "eslint": "^10.8.1",
+    "eslint": "^10.9.0",
     "prettier": "^3.9.6",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.67.0"

package/skills/linear-sdk-cli/SKILL.md

@@ -24,13 +24,10 @@ If that fails, or prints `2.x` (that is `schpet/linear-cli`, a different tool th
 `linear` name), install this one — it needs Bun ≥ 1.1:
 
 ```bash
-git clone https://github.com/zhendalf/linear-sdk-cli.git
-cd linear-sdk-cli && bun install
-bun run dev -- --version
+bun add -g linear-sdk-cli          # installs `linear` and `lin`
+lin --version                      # `lin` never collides with the other CLI
 ```
 
-The npm package has not been published yet; use a source clone until its first release.
-
 `lin` is the safe spelling when both might be present. If the user is coming from
 `schpet/linear-cli`, their credentials and `.linear.toml` are picked up automatically — see
 `MIGRATING.md` in the package; do not ask them to re-enter an API key before running
@@ -198,9 +195,7 @@ EOF
 
 For short, single-line content, use inline `-d/--description` (issues/initiatives),
 the positional `[body]` arg (comments: `linear comment add TES-42 "lgtm"`), or
-`--body` (status updates). There is no `-b` short flag. The CLI rejects an inline
-body containing literal `\n` sequences and points back to stdin; never encode a
-multiline body by inserting `\n` inside an ordinary quoted argument.
+`--body` (status updates). There is no `-b` short flag.
 
 ### Discovery — learn the surface without scraping help
 
@@ -240,7 +235,6 @@ linear attachment delete
 linear attachment list
 
 linear auth
-linear auth adopt
 linear auth default
 linear auth list
 linear auth login
@@ -357,8 +351,6 @@ linear notification read-all
 linear notification snooze
 linear notification unread
 
-linear open
-
 linear organization
 linear organization invites
 linear organization members
@@ -394,7 +386,6 @@ linear team
 linear team create
 linear team cycles
 linear team delete
-linear team id
 linear team labels
 linear team list
 linear team members
@@ -441,7 +432,6 @@ prints the same). These are supplementary — `--help` on any command is authori
 - [label](references/label.md) — Work with issue labels
 - [milestone](references/milestone.md) — Work with project milestones
 - [notification](references/notification.md) — Work with your notifications
-- [open](references/open.md) — Open the workspace, an issue, team, project, or URL
 - [organization](references/organization.md) — Inspect the current workspace
 - [project](references/project.md) — Work with projects
 - [project-update](references/project-update.md) — Post and list project status updates

package/skills/linear-sdk-cli/references/api.md

@@ -14,14 +14,14 @@ Run a raw GraphQL query or mutation against the Linear API
 linear api [options] [query]
 ```
 
-| Option                | Description                                                                    |
-| --------------------- | ------------------------------------------------------------------------------ |
-| `--query-file <path>` | read the query from a file ('-' for stdin)                                     |
-| `--var <k=v...>`      | set a variable (repeatable; JSON literals are typed, other values are strings) |
-| `--vars <json>`       | variables as a JSON object                                                     |
-| `--vars-file <path>`  | read variables from a JSON file ('-' for stdin)                                |
-| `--operation <name>`  | run this operation of a multi-operation document                               |
-| `--paginate`          | auto-follow the first connection's pageInfo cursor (queries only)              |
-| `--raw`               | print the full GraphQL response (data + extensions)                            |
+| Option                | Description                                                       |
+| --------------------- | ----------------------------------------------------------------- |
+| `--query-file <path>` | read the query from a file ('-' for stdin)                        |
+| `--var <k=v...>`      | set a variable (repeatable; string value)                         |
+| `--vars <json>`       | variables as a JSON object                                        |
+| `--vars-file <path>`  | read variables from a JSON file ('-' for stdin)                   |
+| `--operation <name>`  | run this operation of a multi-operation document                  |
+| `--paginate`          | auto-follow the first connection's pageInfo cursor (queries only) |
+| `--raw`               | print the full GraphQL response (data + extensions)               |
 
 **Output (`--json`)**: raw JSON (keys depend on the request) — the response `data` as the API returned it (`--raw`: {data, extensions}); `--paginate` prints one array of every page's nodes

package/skills/linear-sdk-cli/references/auth.md

@@ -14,24 +14,6 @@ Manage authentication
 linear auth [options]
 ```
 
-### `linear auth adopt`
-
-Adopt an existing named credential from the shared OS keyring
-
-```
-linear auth adopt [options] <slug>
-```
-
-**Output (`--json`)**: a receipt object
-
-```text
-success: boolean
-workspace: string
-user: {id: string, name: string, email: string}
-storage: string
-path: string
-```
-
 ### `linear auth default`
 
 Set the default workspace credential

package/skills/linear-sdk-cli/references/commands.md

@@ -21,7 +21,7 @@ path: string
 description: string
 aliases: string[]
 arguments: Array<{name: string, required: boolean, variadic: boolean}>
-options: Array<{flags: string, description: string, attribute: string, valueRequired: boolean, valueOptional: boolean, variadic: boolean, choices?: string[], defaultValue?: unknown, global: boolean, applicable: boolean}>
+options: Array<{flags: string, description: string}>
 output?: {kind: string, fields?: object, note?: string, variants?: object}
 ```
 
@@ -32,6 +32,6 @@ path: string
 description: string
 aliases: string[]
 arguments: Array<{name: string, required: boolean, variadic: boolean}>
-options: Array<{flags: string, description: string, attribute: string, valueRequired: boolean, valueOptional: boolean, variadic: boolean, choices?: string[], defaultValue?: unknown, global: boolean, applicable: boolean}>
+options: Array<{flags: string, description: string}>
 output?: {kind: string, fields?: object, note?: string, variants?: object}
 ```

package/skills/linear-sdk-cli/references/config.md

@@ -23,7 +23,8 @@ credentialWorkspace: string | null
 team: string | null
 workspace: string | null
 sort: string
-origins: {team: {source: string, path?: string, key?: string}, workspace: {source: string, path?: string, key?: string}, sort: {source: string, path?: string, key?: string}}
+vcs: string
+origins: {team: {source: string, path?: string}, workspace: {source: string, path?: string}, sort: {source: string, path?: string}, vcs: {source: string, path?: string}}
 userConfigPath: string
 projectConfigPath: string | null
 globalConfigPath: string | null
@@ -37,12 +38,12 @@ Write a project .linear.toml (at the git root, or here outside a repository)
 linear config init [options]
 ```
 
-| Option           | Description                                                        |
-| ---------------- | ------------------------------------------------------------------ |
-| `--team <key>`   | default team key (otherwise chosen from a list)                    |
-| `--sort <order>` | default issue-list sort (priority \| manual \| updated \| created) |
-| `--path <file>`  | write this file instead of <git root>/.linear.toml                 |
-| `--force`        | overwrite an existing file                                         |
+| Option           | Description                                              |
+| ---------------- | -------------------------------------------------------- |
+| `--team <key>`   | default team key (otherwise chosen from a list)          |
+| `--sort <order>` | default issue-list sort (priority \| updated \| created) |
+| `--path <file>`  | write this file instead of <git root>/.linear.toml       |
+| `--force`        | overwrite an existing file                               |
 
 **Output (`--json`)**: a receipt object
 
@@ -55,7 +56,7 @@ sort?: string
 
 ### `linear config set`
 
-Set one project setting (team, workspace, sort) in the project config
+Set one project setting (team, workspace, sort, vcs) in the project config
 
 ```
 linear config set [options] <key> <value>
@@ -92,7 +93,8 @@ credentialWorkspace: string | null
 team: string | null
 workspace: string | null
 sort: string
-origins: {team: {source: string, path?: string, key?: string}, workspace: {source: string, path?: string, key?: string}, sort: {source: string, path?: string, key?: string}}
+vcs: string
+origins: {team: {source: string, path?: string}, workspace: {source: string, path?: string}, sort: {source: string, path?: string}, vcs: {source: string, path?: string}}
 userConfigPath: string
 projectConfigPath: string | null
 globalConfigPath: string | null

package/skills/linear-sdk-cli/references/issue.md

@@ -44,27 +44,18 @@ team: {id: string, key: string, name: string} | null
 project: {id: string, name: string} | null
 milestone: {id: string, name: string} | null
 cycle: {id: string, number: number, name: string | null} | null
-parent: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null} | null
-children: Array<{id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}>
+parent: {id: string, identifier: string} | null
 labels: Array<{id: string, name: string}>
 subscribers: Array<{id: string, displayName: string}>
-attachments: Array<{id: string, title: string, url: string, subtitle: string | null, sourceType: string | null, createdAt: string}>
-documents: Array<{id: string, title: string, slugId: string, url: string, createdAt: string, updatedAt: string}>
-relations: Array<{id: string, type: string, issue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}, relatedIssue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}}>
-inverseRelations: Array<{id: string, type: string, issue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}, relatedIssue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}}>
-comments: Array<{id: string, body: string, url: string, createdAt: string, editedAt: string | null, resolvedAt: string | null, parent: {id: string} | null, user: {id: string, displayName: string} | null, externalUser: {id: string, displayName: string} | null, resolvingCommentId: string | null, resolvingUser: {id: string, displayName: string} | null}>
 ```
 
-With `--web`: a receipt object
+With `--comments`: the same, plus:
 
 ```text
-id: string
-identifier: string
-url: string
-opened: boolean
+comments: Array<{id: string, body: string, user: {id: string, displayName: string} | null, createdAt: string, editedAt: string | null, resolvedAt: string | null, parent: {id: string} | null, url: string}>
 ```
 
-With `--app`: a receipt object
+With `--web`: a receipt object
 
 ```text
 id: string
@@ -152,12 +143,6 @@ Archive an issue
 linear issue archive [options] [id]
 ```
 
-| Option               | Description                                      |
-| -------------------- | ------------------------------------------------ |
-| `--bulk <ids>`       | archive comma-separated issue ids (repeatable)   |
-| `--bulk-file <path>` | archive issue ids from a file (one per line)     |
-| `--bulk-stdin`       | archive issue ids read from stdin (one per line) |
-
 **Output (`--json`)**: a receipt object
 
 ```text
@@ -166,15 +151,6 @@ identifier: string
 archived: boolean
 ```
 
-With `--bulk`: a receipt object
-
-```text
-action: string
-results: Array<{input: string, id?: string, identifier?: string, archived?: boolean, deleted?: boolean, error?: {message: string, code: string}}>
-succeeded: number
-failed: number
-```
-
 ### `linear issue assign`
 
 Assign an issue (use 'me', email, name, or id). Issue defaults to the branch.
@@ -404,12 +380,6 @@ Aliases: `rm`
 linear issue delete [options] [id]
 ```
 
-| Option               | Description                                     |
-| -------------------- | ----------------------------------------------- |
-| `--bulk <ids>`       | delete comma-separated issue ids (repeatable)   |
-| `--bulk-file <path>` | delete issue ids from a file (one per line)     |
-| `--bulk-stdin`       | delete issue ids read from stdin (one per line) |
-
 **Output (`--json`)**: a receipt object
 
 ```text
@@ -418,15 +388,6 @@ identifier: string
 deleted: boolean
 ```
 
-With `--bulk`: a receipt object
-
-```text
-action: string
-results: Array<{input: string, id?: string, identifier?: string, archived?: boolean, deleted?: boolean, error?: {message: string, code: string}}>
-succeeded: number
-failed: number
-```
-
 ### `linear issue describe`
 
 Print a commit message for the issue: 'ID Title' plus Linear-issue trailers
@@ -829,7 +790,6 @@ linear issue update [options] [id]
 | `--estimate <n>`            | estimate points                                         |
 | `--parent <id>`             | parent issue id                                         |
 | `--due <date>`              | due date (YYYY-MM-DD)                                   |
-| `-l, --label <name>`        | replace all labels (repeatable / comma-separated)       |
 | `--add-label <name>`        | add a label (repeatable)                                |
 | `--remove-label <name>`     | remove a label (repeatable)                             |
 | `--unassign`                | clear the assignee                                      |
@@ -865,12 +825,10 @@ Show an issue (defaults to the current branch's issue)
 linear issue view [options] [id]
 ```
 
-| Option                    | Description                                       |
-| ------------------------- | ------------------------------------------------- |
-| `-w, --web`               | open the issue in the browser instead of printing |
-| `--app`                   | open the issue in Linear.app instead of printing  |
-| `--no-comments`           | exclude comments from the output                  |
-| `--show-resolved-threads` | include resolved comment threads                  |
+| Option       | Description                                       |
+| ------------ | ------------------------------------------------- |
+| `-w, --web`  | open the issue in the browser instead of printing |
+| `--comments` | include recent comments                           |
 
 **Output (`--json`)**: a bare object
 
@@ -898,27 +856,18 @@ team: {id: string, key: string, name: string} | null
 project: {id: string, name: string} | null
 milestone: {id: string, name: string} | null
 cycle: {id: string, number: number, name: string | null} | null
-parent: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null} | null
-children: Array<{id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}>
+parent: {id: string, identifier: string} | null
 labels: Array<{id: string, name: string}>
 subscribers: Array<{id: string, displayName: string}>
-attachments: Array<{id: string, title: string, url: string, subtitle: string | null, sourceType: string | null, createdAt: string}>
-documents: Array<{id: string, title: string, slugId: string, url: string, createdAt: string, updatedAt: string}>
-relations: Array<{id: string, type: string, issue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}, relatedIssue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}}>
-inverseRelations: Array<{id: string, type: string, issue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}, relatedIssue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}}>
-comments: Array<{id: string, body: string, url: string, createdAt: string, editedAt: string | null, resolvedAt: string | null, parent: {id: string} | null, user: {id: string, displayName: string} | null, externalUser: {id: string, displayName: string} | null, resolvingCommentId: string | null, resolvingUser: {id: string, displayName: string} | null}>
 ```
 
-With `--web`: a receipt object
+With `--comments`: the same, plus:
 
 ```text
-id: string
-identifier: string
-url: string
-opened: boolean
+comments: Array<{id: string, body: string, user: {id: string, displayName: string} | null, createdAt: string, editedAt: string | null, resolvedAt: string | null, parent: {id: string} | null, url: string}>
 ```
 
-With `--app`: a receipt object
+With `--web`: a receipt object
 
 ```text
 id: string

package/skills/linear-sdk-cli/references/team.md

@@ -86,22 +86,6 @@ movedIssues: number
 movedTo: {id: string, key: string, name: string} | null
 ```
 
-### `linear team id`
-
-Print a team's UUID (defaults to the configured team)
-
-```
-linear team id [options] [key]
-```
-
-**Output (`--json`)**: a receipt object
-
-```text
-id: string
-key: string
-name: string
-```
-
 ### `linear team labels`
 
 List a team's labels

package/skills/linear-sdk-cli/scripts/generate-docs.ts

@@ -70,10 +70,7 @@ const GLOBAL_OPTIONS = new Map([
   ["-t, --team <key>", "default team key (e.g. TES)"],
   ["-n, --limit <n>", "max results (positive integer; 0 = all)"],
   ["--all", "fetch all results (exhaust pagination)"],
-  [
-    "-f, --fields <a,b,c>",
-    "select fields: table columns or detail lines (human), top-level keys (--json)",
-  ],
+  ["-f, --fields <a,b,c>", "select fields: table columns or detail lines (human), top-level keys (--json)"],
   ["-y, --yes", "skip confirmation prompts"],
   ["-q, --quiet", "suppress status output"],
   ["--no-input", "never prompt; fail instead"],
@@ -193,8 +190,7 @@ function formatOutput(out: OutputShape, heading = "**Output (`--json`)**"): stri
       lines.push(`With \`${when}\`: the same${drop}, plus:`);
       lines.push("");
       lines.push("```text");
-      for (const [key, shape] of Object.entries(delta.added))
-        lines.push(`${key}: ${renderShape(shape)}`);
+      for (const [key, shape] of Object.entries(delta.added)) lines.push(`${key}: ${renderShape(shape)}`);
       lines.push("```");
       lines.push("");
       continue;

package/src/bin/linear.ts

@@ -10,7 +10,6 @@ import { createProgram, parsedGlobalOptions, usageHint, suppressedHelp } from ".
 import { Output } from "../output/format.js";
 import { CliError, ExitCode, normalizeError } from "../lib/errors.js";
 import { commandPath } from "../lib/options.js";
-import { isDebugEnabled, shouldUseColor } from "../output/color.js";
 
 // `linear schema | head -2` is a reader that stops early, and stdout closing
 // under us is that reader's business, not an error: exit quietly, as every
@@ -54,14 +53,9 @@ program.parseAsync(process.argv).catch((err) => {
   const json = globals.json === true;
   const out = new Output({
     json,
-    color: shouldUseColor({
-      disabled: globals.noAnsi,
-      json,
-      isTTY: process.stderr.isTTY === true,
-    }),
+    color: globals.noAnsi !== true && !json && process.stderr.isTTY === true,
     quiet: globals.quiet === true,
-    debug: isDebugEnabled(globals.debug),
-    isTTY: process.stderr.isTTY === true,
+    debug: globals.debug === true,
   });
   out.error(cliError);
   process.exit(cliError.exitCode);
@@ -76,18 +70,14 @@ function fromCommander(err: CommanderError): CliError {
   if (err.code === "commander.help") {
     const help = suppressedHelp(program);
     const path = help ? commandPath(help.command) : "linear";
-    return new CliError(
-      "Missing subcommand.",
-      "usage",
-      err.code,
-      `Run '${path} --help' to see the commands.`,
-    );
+    return new CliError(`Missing subcommand. Run '${path} --help' to see the commands.`, "usage", err.code);
   }
   return new CliError(
-    stripErrorPrefix(err.message).replace(/\.?$/, "."),
+    [stripErrorPrefix(err.message).replace(/\.?$/, "."), usageHint(program)]
+      .filter(Boolean)
+      .join(" "),
     "usage",
     err.code,
-    usageHint(program),
   );
 }
 

package/src/cli.ts

@@ -29,7 +29,6 @@ import { registerRoadmap } from "./commands/roadmap.js";
 import { registerNotification } from "./commands/notification.js";
 import { registerOrganization } from "./commands/organization.js";
 import { registerWebhook } from "./commands/webhook.js";
-import { registerOpen } from "./commands/open.js";
 import { registerCommands, registerSchema } from "./commands/discover.js";
 import { Context, type GlobalOptions } from "./context.js";
 import { currentIssueId } from "./git.js";
@@ -59,7 +58,6 @@ export function createProgram(): Command {
   registerMeta(program);
   registerApi(program);
   registerCompletion(program);
-  registerOpen(program);
   // Phase 1: issues. Agent sessions live on issues, so their group is mounted
   // under `issue` (`linear issue agent-session …`); so is file upload
   // (`linear issue attach <issue> <file...>`, TES-602).
@@ -110,7 +108,7 @@ export function createProgram(): Command {
       return;
     }
     const detail = await getIssueDetail(ctx.client, id);
-    await renderIssueDetail(ctx, detail, true);
+    await renderIssueDetail(ctx, detail, false);
   });
 
   // Make global options usable in any position (e.g. `linear whoami --json`),

package/src/commands/agent-session.ts

@@ -18,12 +18,7 @@ const ROW_COLUMNS: Column<svc.AgentSessionRow>[] = [
   { key: "agent", header: "Agent", value: (r) => r.agent?.displayName ?? "—", max: 20 },
   { key: "issue", header: "Issue", value: (r) => r.issue?.identifier ?? "—" },
   { key: "createdAt", header: "Created", value: (r) => r.createdAt.slice(0, 10) },
-  {
-    key: "summary",
-    header: "Summary",
-    value: (r) => r.summary?.replace(/\n/g, " ") ?? "—",
-    max: 60,
-  },
+  { key: "summary", header: "Summary", value: (r) => r.summary?.replace(/\n/g, " ") ?? "—", max: 60 },
   { key: "id", header: "ID", value: (r) => r.id },
 ];
 
@@ -93,12 +88,7 @@ export function registerAgentSession(issue: Command): void {
           ["Created", d.createdAt],
           ["Started", d.startedAt],
           ["Ended", d.endedAt],
-          [
-            "Dismissed",
-            d.dismissedAt
-              ? `${d.dismissedAt}${d.dismissedBy ? ` by ${d.dismissedBy.displayName}` : ""}`
-              : null,
-          ],
+          ["Dismissed", d.dismissedAt ? `${d.dismissedAt}${d.dismissedBy ? ` by ${d.dismissedBy.displayName}` : ""}` : null],
           ["External link", d.externalLink],
           ["URL", d.url],
           ["Summary", d.summary ? `\n${d.summary}` : null],
@@ -113,7 +103,9 @@ function renderActivities(d: svc.AgentSessionDetail): string {
   const lines = d.activities.map((a) => {
     const when = a.createdAt.slice(11, 19);
     const text =
-      a.action !== null ? `${a.action}${a.parameter ? `: ${a.parameter}` : ""}` : (a.body ?? "");
+      a.action !== null
+        ? `${a.action}${a.parameter ? `: ${a.parameter}` : ""}`
+        : (a.body ?? "");
     return `- ${when} ${a.type}: ${text.replace(/\s*\n\s*/g, " ")}`;
   });
   if (d.activitiesTruncated) lines.push(`… more activities not shown (use --json)`);

package/src/commands/api.ts

@@ -32,12 +32,7 @@ export function registerApi(program: Command): void {
     .command("api [query]")
     .description("Run a raw GraphQL query or mutation against the Linear API")
     .option("--query-file <path>", "read the query from a file ('-' for stdin)")
-    .option(
-      "--var <k=v...>",
-      "set a variable (repeatable; JSON literals are typed, other values are strings)",
-      collectKeyVal,
-      {},
-    )
+    .option("--var <k=v...>", "set a variable (repeatable; string value)", collectKeyVal, {})
     .option("--vars <json>", "variables as a JSON object")
     .option("--vars-file <path>", "read variables from a JSON file ('-' for stdin)")
     .option("--operation <name>", "run this operation of a multi-operation document")
@@ -107,11 +102,6 @@ function readFileOrThrow(path: string, label: string): string {
 }
 
 function resolveQuery(arg: string | undefined, file: string | undefined): string {
-  if (arg !== undefined && file !== undefined) {
-    throw usageError(
-      "Pass the GraphQL query either as an argument or with --query-file, not both.",
-    );
-  }
   let query: string | undefined;
   if (arg !== undefined) query = arg;
   else if (file !== undefined) query = readFileOrThrow(file, "--query-file");
@@ -129,7 +119,7 @@ function resolveVariables(opts: Record<string, any>): Record<string, unknown> {
     vars = { ...vars, ...parseJsonObject(text, "--vars-file") };
   }
   if (opts.vars) vars = { ...vars, ...parseJsonObject(opts.vars, "--vars") };
-  if (opts.var) vars = { ...vars, ...(opts.var as Record<string, unknown>) };
+  if (opts.var) vars = { ...vars, ...(opts.var as Record<string, string>) };
   return vars;
 }
 
@@ -227,7 +217,10 @@ function describeNames(operations: OperationDefinitionNode[]): string {
   return operations.map((o) => o.name?.value ?? "<unnamed>").join(", ");
 }
 
-function unknownOperationMessage(requested: string, operations: OperationDefinitionNode[]): string {
+function unknownOperationMessage(
+  requested: string,
+  operations: OperationDefinitionNode[],
+): string {
   const named = operations.filter((o) => o.name).map((o) => o.name!.value);
   const available = named.length
     ? `Available: ${named.join(", ")}.`
@@ -276,6 +269,7 @@ async function paginate(
   variables: Record<string, unknown>,
 ): Promise<{ nodes: unknown[]; pageCount: number; truncated: boolean }> {
   let after: string | undefined = variables.after as string | undefined;
+  let firstData: any;
   const allNodes: unknown[] = [];
   let pages = 0;
   let truncated = false;
@@ -284,10 +278,10 @@ async function paginate(
     const result: any = await withRetry(() =>
       (ctx.client.client as any).rawRequest(query, { ...variables, after }),
     );
+    if (!firstData) firstData = result.data;
     const conn = findConnection(result.data);
     if (!conn) {
-      if (pages === 0)
-        throw new CliError("No connection (nodes/pageInfo) found to paginate.", "usage");
+      if (pages === 0) throw new CliError("No connection (nodes/pageInfo) found to paginate.", "usage");
       break;
     }
     allNodes.push(...conn.nodes);

package/src/commands/attach.ts

@@ -27,14 +27,8 @@ export function registerAttach(issue: Command): void {
     .command("attach <issue> <file...>")
     .description("Upload files and attach them to an issue (private by default)")
     .option("--title <title>", "attachment title (single file only; default: the file name)")
-    .option(
-      "--comment <body>",
-      "also post a comment with this body embedding the files as markdown",
-    )
-    .option(
-      "--public",
-      "upload to a public, world-readable URL (raster images only; default: private)",
-    )
+    .option("--comment <body>", "also post a comment with this body embedding the files as markdown")
+    .option("--public", "upload to a public, world-readable URL (raster images only; default: private)")
     .addHelpText(
       "after",
       [
@@ -56,13 +50,8 @@ export function registerAttach(issue: Command): void {
           comment: opts.comment,
           public: opts.public === true,
           onAttached: (a, iss) => {
-            ctx.output.success(
-              `Attached ${a.filename} (${formatBytes(a.size)}) to ${iss.identifier}`,
-            );
-            if (a.public)
-              ctx.output.warn(
-                `${a.filename} is on a public URL, readable by anyone: ${a.assetUrl}`,
-              );
+            ctx.output.success(`Attached ${a.filename} (${formatBytes(a.size)}) to ${iss.identifier}`);
+            if (a.public) ctx.output.warn(`${a.filename} is on a public URL, readable by anyone: ${a.assetUrl}`);
           },
         });
         const identifier = result.issue.identifier;

package/src/commands/comment.ts

@@ -57,10 +57,7 @@ function buildAdd(_o: MountOptions): Command {
       "upload a file and embed it in the comment (images inline; repeatable; private by default)",
       collectArray,
     )
-    .option(
-      "--public",
-      "upload the attachments to public, world-readable URLs (raster images only)",
-    )
+    .option("--public", "upload the attachments to public, world-readable URLs (raster images only)")
     .action(
       action(async (ctx: Context, opts, issueArg: string, bodyArg?: string) => {
         const attachments: string[] = opts.attach ?? [];
@@ -84,8 +81,7 @@ function buildAdd(_o: MountOptions): Command {
           public: opts.public === true,
         });
         for (const u of uploads) {
-          if (u.public)
-            ctx.output.warn(`${u.filename} is on a public URL, readable by anyone: ${u.assetUrl}`);
+          if (u.public) ctx.output.warn(`${u.filename} is on a public URL, readable by anyone: ${u.assetUrl}`);
         }
         ctx.output.emit(
           {