From 2ab86ba26d588644869750384d33c2a33c1bc8ba Mon Sep 17 00:00:00 2001 From: c-99-e <268417377+c-99-e@users.noreply.github.com> Date: Wed, 18 Mar 2026 21:00:24 +0400 Subject: [PATCH 1/4] skill: add bunx fallback, document required flags and --no-pager limitation --- skills/linear-cli/SKILL.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/skills/linear-cli/SKILL.md b/skills/linear-cli/SKILL.md index 2812806f..63cf5afa 100644 --- a/skills/linear-cli/SKILL.md +++ b/skills/linear-cli/SKILL.md @@ -16,7 +16,13 @@ The `linear` command must be available on PATH. To check: linear --version ``` -If not installed, follow the instructions at:\ +If not installed globally, you can run it without installing via Bun: + +```bash +bunx linear --version +``` + +All subsequent commands can be prefixed with `bunx` in place of `linear`. Otherwise, follow the install instructions at:\ https://github.com/schpet/linear-cli?tab=readme-ov-file#install ## Best Practices for Markdown Content @@ -108,6 +114,11 @@ linear issue create --help Each command has detailed help output describing all available flags and options. +Some commands have required flags that aren't obvious. Notable examples: + +- `issue list` requires `--sort` (valid values: `manual`, `priority`) and `--team ` unless the team can be inferred from the directory. If the team is unknown, run `linear team list` first to find the key. +- `--no-pager` is only supported on `issue list` — passing it to other commands like `project list` will error. + ## Using the Linear GraphQL API Directly **Prefer the CLI for all supported operations.** The `api` command should only be used as a fallback for queries not covered by the CLI. From a66dfdaee064b886faf074bdfb6d9f0f010492c7 Mon Sep 17 00:00:00 2001 From: c-99-e <268417377+c-99-e@users.noreply.github.com> Date: Wed, 18 Mar 2026 21:02:26 +0400 Subject: [PATCH 2/4] skill: use package-manager agnostic examples for running without global install --- skills/linear-cli/SKILL.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/skills/linear-cli/SKILL.md b/skills/linear-cli/SKILL.md index 63cf5afa..5ef20c7e 100644 --- a/skills/linear-cli/SKILL.md +++ b/skills/linear-cli/SKILL.md @@ -16,13 +16,14 @@ The `linear` command must be available on PATH. To check: linear --version ``` -If not installed globally, you can run it without installing via Bun: +If not installed globally, you can run it without installing via your package manager: ```bash -bunx linear --version +npx linear --version # npm +bunx linear --version # bun ``` -All subsequent commands can be prefixed with `bunx` in place of `linear`. Otherwise, follow the install instructions at:\ +All subsequent commands can be prefixed with `npx` or `bunx` in place of `linear`. Otherwise, follow the install instructions at:\ https://github.com/schpet/linear-cli?tab=readme-ov-file#install ## Best Practices for Markdown Content From 7e11b3ed051e61c19d6e9b5c9295b4d1e560d2fd Mon Sep 17 00:00:00 2001 From: c-99-e <268417377+c-99-e@users.noreply.github.com> Date: Thu, 19 Mar 2026 03:05:32 +0400 Subject: [PATCH 3/4] skill: fix npx package name and clarify --sort alternatives --- skills/linear-cli/SKILL.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/skills/linear-cli/SKILL.md b/skills/linear-cli/SKILL.md index 5ef20c7e..cd4c181d 100644 --- a/skills/linear-cli/SKILL.md +++ b/skills/linear-cli/SKILL.md @@ -16,14 +16,13 @@ The `linear` command must be available on PATH. To check: linear --version ``` -If not installed globally, you can run it without installing via your package manager: +If not installed globally, you can run it without installing via npx: ```bash -npx linear --version # npm -bunx linear --version # bun +npx @schpet/linear-cli --version ``` -All subsequent commands can be prefixed with `npx` or `bunx` in place of `linear`. Otherwise, follow the install instructions at:\ +All subsequent commands can be prefixed with `npx @schpet/linear-cli` in place of `linear`. Otherwise, follow the install instructions at:\ https://github.com/schpet/linear-cli?tab=readme-ov-file#install ## Best Practices for Markdown Content @@ -117,7 +116,7 @@ Each command has detailed help output describing all available flags and options Some commands have required flags that aren't obvious. Notable examples: -- `issue list` requires `--sort` (valid values: `manual`, `priority`) and `--team ` unless the team can be inferred from the directory. If the team is unknown, run `linear team list` first to find the key. +- `issue list` requires a sort order — provide it via `--sort` (valid values: `manual`, `priority`), the `issue_sort` config option, or the `LINEAR_ISSUE_SORT` env var. Also requires `--team ` unless the team can be inferred from the directory — if unknown, run `linear team list` first. - `--no-pager` is only supported on `issue list` — passing it to other commands like `project list` will error. ## Using the Linear GraphQL API Directly From 581555f3d90d47ce5cc6d75fcfa70af0ff1b5a9e Mon Sep 17 00:00:00 2001 From: c-99-e <268417377+c-99-e@users.noreply.github.com> Date: Thu, 19 Mar 2026 03:14:46 +0400 Subject: [PATCH 4/4] skill: move changes to SKILL.template.md and regenerate SKILL.md --- skills/linear-cli/SKILL.template.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/skills/linear-cli/SKILL.template.md b/skills/linear-cli/SKILL.template.md index 0d2294b0..8d733671 100644 --- a/skills/linear-cli/SKILL.template.md +++ b/skills/linear-cli/SKILL.template.md @@ -16,7 +16,13 @@ The `linear` command must be available on PATH. To check: linear --version ``` -If not installed, follow the instructions at:\ +If not installed globally, you can run it without installing via npx: + +```bash +npx @schpet/linear-cli --version +``` + +All subsequent commands can be prefixed with `npx @schpet/linear-cli` in place of `linear`. Otherwise, follow the install instructions at:\ https://github.com/schpet/linear-cli?tab=readme-ov-file#install ## Best Practices for Markdown Content @@ -80,6 +86,11 @@ linear issue create --help Each command has detailed help output describing all available flags and options. +Some commands have required flags that aren't obvious. Notable examples: + +- `issue list` requires a sort order — provide it via `--sort` (valid values: `manual`, `priority`), the `issue_sort` config option, or the `LINEAR_ISSUE_SORT` env var. Also requires `--team ` unless the team can be inferred from the directory — if unknown, run `linear team list` first. +- `--no-pager` is only supported on `issue list` — passing it to other commands like `project list` will error. + ## Using the Linear GraphQL API Directly **Prefer the CLI for all supported operations.** The `api` command should only be used as a fallback for queries not covered by the CLI.