@kyaukyuai/linear-cli 2.0.1 → 2.2.0

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 ## [Unreleased]
 
+## [2.2.0] - 2026-03-15
+
+### Added
+
+- added `workflow-state list` and `workflow-state view` commands with team-scoped and JSON output support
+- added `user list` and `user view` commands for organization-wide user lookup with JSON output support
+- added `project-label list` plus `project label add/remove` commands for project label discovery and assignment
+
+### Improved
+
+- documented ClawHub skill publishing for the published `kyaukyuai-linear-cli` slug and fixed npm release tarball handling for future releases
+
+## [2.1.0] - 2026-03-13
+
+### Added
+
+- added inbox notification commands for `list`, `count`, `read`, and `archive`, including `--json` output for scripting
+- added webhook commands for `list`, `view`, `create`, `update`, and `delete` with team-scoped and all-public-team support
+
+### Changed
+
+- deprecated `issue search`; it now exits with guidance to use `issue list`, `issue list --json`, or `api` instead of the removed search endpoint
+
+### Improved
+
+- hardened release automation by splitting npm publish from cargo-dist release flow, skipping already-published npm/JSR versions, removing npm release-asset polling, and updating GitHub Actions for the Node 24 transition
+- added a release runbook for verification, recovery steps, and manual publish fallback
+
 ## [2.0.1] - 2026-03-13
 
 ### Improved
@@ -440,7 +468,9 @@
 - adds a -t, --title flag to the `issue pr` command, allowing you to provide a PR title that is different than linear's issue title
 - allows linear issue identifiers to be passed in as arguments to the issue commands as an alternative to parsing the branch name, e.g. `linear issue show ABC-123`
 
-[Unreleased]: https://github.com/kyaukyuai/linear-cli/compare/v2.0.1...HEAD
+[Unreleased]: https://github.com/kyaukyuai/linear-cli/compare/v2.2.0...HEAD
+[2.2.0]: https://github.com/kyaukyuai/linear-cli/compare/v2.1.0...v2.2.0
+[2.1.0]: https://github.com/kyaukyuai/linear-cli/compare/v2.0.1...v2.1.0
 [2.0.1]: https://github.com/kyaukyuai/linear-cli/compare/v2.0.0...v2.0.1
 [2.0.0]: https://github.com/kyaukyuai/linear-cli/compare/v1.11.1...v2.0.0
 [1.11.1]: https://github.com/schpet/linear-cli/compare/v1.11.0...v1.11.1

package/README.md

@@ -91,6 +91,11 @@ compared to upstream, this fork adds and maintains several capabilities aimed at
 
 - cycle workflows beyond listing and viewing, including `cycle current`, `cycle next`, `cycle create`, `cycle add`, and `cycle remove`
 - issue workflow commands for `search`, `assign`, `move`, `priority`, `estimate`, `label add/remove`, comment delete, relations, and attachments
+- inbox notification commands for `list`, `count`, `read`, and `archive`
+- webhook commands for `list`, `view`, `create`, `update`, and `delete`
+- workflow state commands for `list` and `view`
+- user commands for `list` and `view`
+- project label commands for `list` and `project label add/remove`
 - JSON output for scripting across issue, cycle, project, and document commands
 - 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
@@ -182,6 +187,8 @@ linear team autolinks  # configure GitHub repository autolinks for Linear issues
 ```bash
 linear project list    # list projects
 linear project view    # view project details
+linear project label add <projectIdOrSlug> <labelNameOrId>     # attach a project label
+linear project label remove <projectIdOrSlug> <labelNameOrId>  # detach a project label
 ```
 
 ### milestone commands
@@ -235,6 +242,66 @@ linear document delete <slug> --permanent       # permanent delete
 linear document delete --bulk <slug1> <slug2>   # bulk delete
 ```
 
+### notification commands
+
+manage your Linear inbox from the command line with a primitive GraphQL-aligned surface.
+
+```bash
+linear notification list                  # list recent notifications
+linear notification list --unread         # show only unread notifications
+linear notification count                 # show unread notification count
+linear notification read <notificationId> # mark a notification as read
+linear notification archive <notificationId>  # archive a notification
+linear notification list --json           # output as JSON
+```
+
+### webhook commands
+
+manage Linear webhooks with a primitive GraphQL-aligned surface.
+
+```bash
+linear webhook list
+linear webhook list --team ENG
+linear webhook view <webhookId>
+linear webhook create --url https://example.com/linear --resource-types Issue,Comment
+linear webhook update <webhookId> --disabled
+linear webhook delete <webhookId> --yes
+linear webhook list --json
+```
+
+### workflow state commands
+
+inspect workflow states directly, without going through issue mutations.
+
+```bash
+linear workflow-state list --team ENG
+linear workflow-state list --json
+linear workflow-state view <workflowStateId>
+linear workflow-state view <workflowStateId> --json
+```
+
+### project label commands
+
+inspect workspace project labels directly with a primitive GraphQL-aligned surface.
+
+```bash
+linear project-label list
+linear project-label list --include-archived
+linear project-label list --json
+```
+
+### user commands
+
+inspect workspace users directly with a primitive GraphQL-aligned surface.
+
+```bash
+linear user list
+linear user list --all
+linear user list --json
+linear user view <userId>
+linear user view <userId> --json
+```
+
 ### other commands
 
 ```bash
@@ -296,8 +363,40 @@ npx skills add kyaukyuai/linear-cli
 
 view the skill at [skills.sh/kyaukyuai/linear-cli/linear-cli](https://skills.sh/kyaukyuai/linear-cli/linear-cli)
 
+### clawhub publish for maintainers
+
+if you want to publish the generated skill to ClawHub, use the `skills/linear-cli/` directory as the publish target.
+
+> **note:** the CLI is `clawhub`, not `clawdhub`
+
+```bash
+cd skills/linear-cli
+npx clawhub@latest login
+npx clawhub@latest whoami
+npx clawhub@latest publish . \
+  --slug kyaukyuai-linear-cli \
+  --name "Linear CLI" \
+  --version 2.1.0 \
+  --changelog "Refresh skill docs for linear-cli v2.1.0" \
+  --tags latest
+```
+
+guidance:
+
+- publish from `skills/linear-cli/`, not the repository root
+- keep `--slug kyaukyuai-linear-cli` and `--name "Linear CLI"` stable unless the public skill identity changes
+- when the skill matches a CLI release, prefer using the same version as `deno.json` and `CHANGELOG.md`
+- if the skill contents changed but no CLI release was cut, bump the skill version independently before publishing
+- run `deno task generate-skill-docs` first if command help or skill references changed
+
+the generic `linear-cli` slug is already taken on ClawHub, so this fork publishes as `kyaukyuai-linear-cli`.
+
 ## development
 
+### release operations
+
+maintainer release and publish recovery steps are documented in [docs/release-runbook.md](docs/release-runbook.md).
+
 ### updating skill documentation
 
 the skill documentation in `skills/linear-cli/` is automatically generated from the CLI help text. after making changes to commands or help text, regenerate the docs:

package/npm-shrinkwrap.json

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

package/package.json

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