@kyaukyuai/linear-cli 2.12.0 → 2.12.1

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## [Unreleased]
 
+## [2.12.1] - 2026-03-30
+
+### Added
+
+- added `stateName` to `issue list --json` as an additive convenience field while keeping the nested `state` object unchanged
+
+### Changed
+
+- refreshed the README, agent workflow docs, and skills.sh install guidance to better position `linear-cli` as an agent-first Linear CLI
+
+### Fixed
+
+- preserved agent-first generated skill docs so `deno task generate-skill-docs` no longer reverts the published skill description and command guidance
+
 ## [2.12.0] - 2026-03-30
 
 ### Added

package/README.md

@@ -16,6 +16,22 @@ linear notification list --json
 
 interactive commands still exist for humans, but the primary design goal is that an agent can discover commands incrementally, pass all important input as flags or stdin, and get machine-readable success or failure back.
 
+## for agents
+
+If an agent only reads one page, it should be this README plus the two contract docs below.
+
+- start with `linear capabilities --json` to discover which commands support `--json`, `--dry-run`, stdin, confirmation bypass, and stable automation contracts
+- prefer stable read surfaces such as `issue`, `project`, `cycle`, `milestone`, `document`, `webhook`, `notification`, `team`, `user`, `workflow-state`, `label`, `initiative`, and update feeds with `--json`
+- preview writes with `--dry-run --json` before mutating Linear
+- apply writes with `--json`, then inspect exit codes and `error.details` instead of parsing terminal text
+- use stdin or file flags for Markdown-heavy descriptions and comments instead of long inline shell strings
+
+Recommended docs:
+
+- [Agent workflow guide](docs/agent-first.md)
+- [Automation contracts](docs/json-contracts.md)
+- [stdin and pipeline policy](docs/stdin-policy.md)
+
 ## screencast demos
 
 <details>
@@ -36,6 +52,24 @@ interactive commands still exist for humans, but the primary design goal is that
 
 for agents and scripts, prefer a pinned install in the repo or runtime you control.
 
+### install as a skill
+
+If you want to expose `linear-cli` as a reusable skill on top of an existing agent runtime, install it from the repo root and select the public skill explicitly:
+
+```bash
+npx skills add https://github.com/kyaukyuai/linear-cli --skill linear-cli
+```
+
+This is the most compatible form for `skills` and `skills.sh`.
+
+If you want to point directly at the skill directory instead, this also works:
+
+```bash
+npx skills add https://github.com/kyaukyuai/linear-cli/tree/main/skills/linear-cli
+```
+
+Once installed, agents can load the skill and then call the local `linear` binary using the agent-first guidance in [skills/linear-cli/SKILL.md](skills/linear-cli/SKILL.md).
+
 ### npm / bun / pnpm
 
 install as a dependency to pin a version in your project:
@@ -59,6 +93,8 @@ bunx linear issue list
 
 package on npm: [@kyaukyuai/linear-cli](https://www.npmjs.com/package/@kyaukyuai/linear-cli)
 
+skills directory on GitHub: [skills/linear-cli](https://github.com/kyaukyuai/linear-cli/tree/main/skills/linear-cli)
+
 ### deno via jsr
 
 ```bash
@@ -106,6 +142,15 @@ compared to upstream, this fork adds and maintains capabilities aimed at automat
 - workspace-aware auth management with keyring migration and default workspace support
 - generated AI-agent skill docs, Claude plugin metadata, npm publishing, and Homebrew tap release plumbing
 
+## docs map
+
+Use the docs in this order if you are building an agent integration:
+
+1. [docs/agent-first.md](docs/agent-first.md) for the recommended discover/read/preview/apply/recover loop
+2. [docs/json-contracts.md](docs/json-contracts.md) for stable JSON payloads, exit codes, timeout semantics, and dry-run envelopes
+3. [docs/stdin-policy.md](docs/stdin-policy.md) for pipeline and file-input conventions
+4. [`linear capabilities --json`](#automation-contract) for machine-readable command metadata at runtime
+
 ## automation contract
 
 for bot and org-wide automation use cases, `linear-cli` defines a stable JSON contract for a focused automation tier.

package/npm-shrinkwrap.json

@@ -23,7 +23,7 @@
       "hasInstallScript": true,
       "license": "MIT",
       "name": "@kyaukyuai/linear-cli",
-      "version": "2.12.0"
+      "version": "2.12.1"
     },
     "node_modules/@isaacs/cliui": {
       "engines": {
@@ -542,5 +542,5 @@
     }
   },
   "requires": true,
-  "version": "2.12.0"
+  "version": "2.12.1"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "artifactDownloadUrls": [
-    "https://github.com/kyaukyuai/linear-cli/releases/download/v2.12.0"
+    "https://github.com/kyaukyuai/linear-cli/releases/download/v2.12.1"
   ],
   "bin": {
     "linear": "run-linear.js"
@@ -85,7 +85,7 @@
       "zipExt": ".tar.xz"
     }
   },
-  "version": "2.12.0",
+  "version": "2.12.1",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"