linear-sdk-cli 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ Release Please generates this file from Conventional Commits. Feature and fix pu
 not edit it directly; their squash-commit titles are the release-note source of truth. This project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.0](https://github.com/zhendalf/linear-sdk-cli/compare/v0.6.0...v0.7.0) (2026-09-18)
+
+### Features
+
+- add changelog command ([#75](https://github.com/zhendalf/linear-sdk-cli/issues/75)) ([b095e77](https://github.com/zhendalf/linear-sdk-cli/commit/b095e7782ae3fb323ce9004883c7fb047f252c63))
+
 ## [0.6.0](https://github.com/zhendalf/linear-sdk-cli/compare/v0.5.3...v0.6.0) (2026-09-17)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linear-sdk-cli",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Ergonomic command-line interface for Linear, built on @linear/sdk",
   "type": "module",
   "license": "MIT",

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

@@ -316,6 +316,8 @@ linear auth status
 linear auth token
 linear auth whoami
 
+linear changelog
+
 linear commands
 
 linear comment
@@ -520,6 +522,7 @@ prints the same). These are supplementary — `--help` on any command is authori
 - [api](references/api.md) — Run a raw GraphQL query or mutation against the Linear API
 - [attachment](references/attachment.md) — Work with issue attachments
 - [auth](references/auth.md) — Manage authentication
+- [changelog](references/changelog.md) — Show recent CLI release notes
 - [commands](references/commands.md) — Machine-readable command tree (for scripts/agents)
 - [comment](references/comment.md) — Manage comments
 - [completion](references/completion.md) — Output a shell completion script

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

@@ -0,0 +1,24 @@
+# linear changelog
+
+> Show recent CLI release notes
+
+_Generated from `linear commands --json`. `linear changelog --help` (or `<subcommand> --help`) is authoritative._
+
+Every command also accepts the global flags `-j/--json`, `--no-input`, `-y/--yes`, `-q/--quiet`, `--workspace <slug>`, `--api-key <key>`, `--access-token <token>`, `-t/--team <key>`, `-n/--limit <n>`, `--all`, `-f/--fields <a,b,c>`, `--no-ansi` (alias `--no-color`), and `--debug`. Only command-specific options are listed below.
+
+### `linear changelog`
+
+Show recent CLI release notes
+
+```
+linear changelog [options]
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+version: string
+date: string
+url: string
+sections: Array<{title: string, items: string[]}>
+```

package/src/cli.ts

@@ -8,6 +8,7 @@ import { addGlobalOptions, globalOptionKeys, unknownCommand, commandPath } from
 import { registerMeta } from "./commands/meta.js";
 import { registerApi } from "./commands/api.js";
 import { registerCompletion } from "./commands/completion.js";
+import { registerChangelog } from "./commands/changelog.js";
 import { registerIssue, renderIssueDetail } from "./commands/issue.js";
 import { registerAgentSession } from "./commands/agent-session.js";
 import { registerAttach } from "./commands/attach.js";
@@ -62,6 +63,7 @@ export function createProgram(): Command {
   registerMeta(program);
   registerApi(program);
   registerCompletion(program);
+  registerChangelog(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

package/src/commands/changelog.ts

@@ -0,0 +1,108 @@
+/** Show release notes from the CHANGELOG.md bundled with the CLI package. */
+
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+import { action } from "../lib/action.js";
+import { CliError } from "../lib/errors.js";
+import type { Context } from "../context.js";
+
+export interface ChangelogSection {
+  title: string;
+  items: string[];
+}
+
+export interface ChangelogRelease {
+  version: string;
+  date: string;
+  url: string;
+  sections: ChangelogSection[];
+}
+
+const CHANGELOG_PATH = fileURLToPath(new URL("../../CHANGELOG.md", import.meta.url));
+const DEFAULT_RELEASE_COUNT = 3;
+
+/** Parse the Release Please Markdown format into a stable machine-readable shape. */
+export function parseChangelog(markdown: string): ChangelogRelease[] {
+  const releases: ChangelogRelease[] = [];
+  const releasePattern = /^## \[([^\]]+)]\(([^)]+)\) \((\d{4}-\d{2}-\d{2})\)\s*$/gm;
+  const matches = [...markdown.matchAll(releasePattern)];
+
+  for (const [index, match] of matches.entries()) {
+    const bodyStart = (match.index ?? 0) + match[0].length;
+    const bodyEnd = matches[index + 1]?.index ?? markdown.length;
+    const body = markdown.slice(bodyStart, bodyEnd);
+    const sections: ChangelogSection[] = [];
+    const sectionPattern = /^### (.+)\s*$/gm;
+    const sectionMatches = [...body.matchAll(sectionPattern)];
+
+    for (const [sectionIndex, sectionMatch] of sectionMatches.entries()) {
+      const itemsStart = (sectionMatch.index ?? 0) + sectionMatch[0].length;
+      const itemsEnd = sectionMatches[sectionIndex + 1]?.index ?? body.length;
+      const itemsBody = body.slice(itemsStart, itemsEnd).trim();
+      const items = itemsBody
+        .split(/\n(?=- )/)
+        .map((item) => item.replace(/^- /, "").replace(/\n\s+/g, " ").trim())
+        .filter(Boolean);
+      sections.push({ title: sectionMatch[1]!.trim(), items });
+    }
+
+    releases.push({
+      version: match[1]!,
+      url: match[2]!,
+      date: match[3]!,
+      sections,
+    });
+  }
+
+  return releases;
+}
+
+export function registerChangelog(program: Command): void {
+  program
+    .command("changelog")
+    .description("Show recent CLI release notes")
+    .addHelpText(
+      "after",
+      [
+        "",
+        "Examples:",
+        "  linear changelog                 # latest three releases",
+        "  linear changelog --limit 1       # latest release only",
+        "  linear changelog --all           # complete bundled history",
+        "  linear changelog --json          # structured release notes",
+      ].join("\n"),
+    )
+    .action(action(runChangelog));
+}
+
+export function runChangelog(ctx: Context): void {
+  let markdown: string;
+  try {
+    markdown = readFileSync(CHANGELOG_PATH, "utf8");
+  } catch (error) {
+    throw new CliError(`Cannot read the bundled changelog: ${(error as Error).message}`, "runtime");
+  }
+
+  const releases = parseChangelog(markdown);
+  const count =
+    ctx.options.all || ctx.options.limit === 0
+      ? releases.length
+      : (ctx.options.limit ?? DEFAULT_RELEASE_COUNT);
+  const recent = releases.slice(0, count);
+
+  ctx.output.emit(recent, () => {
+    const rendered = recent
+      .map((release) => {
+        const sections = release.sections
+          .map(
+            (section) =>
+              `### ${section.title}\n\n${section.items.map((item) => `- ${item}`).join("\n")}`,
+          )
+          .join("\n\n");
+        return `## [${release.version}](${release.url}) (${release.date})\n\n${sections}`;
+      })
+      .join("\n\n");
+    ctx.output.markdown(rendered);
+  });
+}

package/src/lib/action.ts

@@ -27,7 +27,7 @@ export function action(handler: ActionHandler) {
     let group = command;
     while (group.parent?.parent) group = group.parent;
     const offline =
-      ["config", "open", "commands", "completion"].includes(group.name()) ||
+      ["config", "open", "commands", "completion", "changelog"].includes(group.name()) ||
       (group.name() === "auth" && !["whoami", "status", "token"].includes(command.name()));
     if (!offline) await ctx.selectWorkspace();
     try {

package/src/lib/options.ts

@@ -422,8 +422,9 @@ export const FIELDS_COMMANDS: ReadonlySet<string> = new Set([
   "webhook view",
 ]);
 
-/** Commands that page through a query: `--limit <n>` caps them, `--all` (or `--limit 0`) exhausts them. */
+/** Commands with bounded lists: `--limit <n>` caps them, `--all` (or `--limit 0`) exhausts them. */
 export const LIMIT_COMMANDS: ReadonlySet<string> = new Set([
+  "changelog",
   "attachment list",
   "comment list",
   "cycle list",

package/src/lib/output-shapes.ts

@@ -313,6 +313,13 @@ const RAW_API: OutputShape = {
 export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
   api: RAW_API,
 
+  changelog: list({
+    version: "string",
+    date: "string",
+    url: "string",
+    sections: [{ title: "string", items: ["string"] }],
+  }),
+
   attachment: null,
   "attachment create": receipt({ id: "string", title: "string", url: "string" }),
   "attachment delete": receipt({ id: "string", title: "string", deleted: "boolean" }),