Use linear-cli
Drive nesszer/linear-cli, whose executable is linear-cli. This skill targets release 0.3.28. Check linear-cli --version; use the installed command's help when versions differ.
Read live compatibility before using remote templates, time tracking, or bulk previews.
Workflow
- Discover unfamiliar commands/flags through the installed command’s
--help. command-surface.md indexes the public tree. Global flag acceptance does not prove handler support.
- Verify identity once per session and after profile changes with
linear-cli u me --output json. auth status --validate can exit 0 without validated credentials; see setup.md for auth precedence.
- Resolve scope. Resolve team keys, assignees, labels, workflow states, project names, and issue identifiers from actual data. Never pick the first team or invent IDs. Respect the user's chosen tool and workspace.
- Read before changing. Fetch current values and the exact target set. For generated bulk sets, save and inspect IDs, count them, and preview the intended changes. Use
--dry-run where supported; its coverage differs by command. Keep the concrete target set within the user’s authorization.
- Execute and reconcile. Capture successful IDs and per-item results. Re-read changed resources. Partial failures are not transactions: restore a previous value only if it was captured and the follow-up change is authorized.
Output rules
- Request
--output json for structured results, and keep stdout and stderr separate. Runtime JSON errors go to stderr; parser failures are plain text. Some handlers still emit prose or no JSON.
- Use
--id-only only on handlers that implement it, such as issue create/update. i list --id-only does not produce a plain ID list; extract identifiers from JSON with jq.
- Set
LINEAR_CLI_NO_PAGER=true in agent runs. Use --yes or a command's --force only for an authorized operation; there is no global -y alias.
Common reads
linear-cli --version
linear-cli u me --output json
linear-cli t list --output json
linear-cli i list --mine -t ENG --output json --fields identifier,title,state.name
linear-cli i get LIN-123 --output json
linear-cli context --output json
ENG and LIN-123 are placeholders to replace with resolved values. i list defaults to a limited page and does not filter to open issues. i get LIN-1 LIN-2 performs concurrent per-ID requests; JSON results may be sorted and partial failures still exit nonzero.
Route to the task
Read only the relevant reference. Bash recipes use Bash syntax; the checklist recipes support macOS's Bash 3.2.
| Task |
Reference |
| Checklist, CSV, JSON, template, or parent/child bulk creation |
creating-many-issues.md |
| Start work, create a GitHub PR, branch context, jj, stop work |
git-and-pr-loop.md |
| Triage queue, comments, screenshots, attachments |
triage-and-comments.md |
| Issue create/update, JSON input, transitions, move/transfer, archive/delete |
lifecycle.md |
| Search/list filters, saved views, favorites |
search-and-filter.md |
| Relations, labels, statuses, local and remote templates |
relations-and-labels.md |
| Projects, updates, cycles, sprints, milestones, roadmaps, initiatives |
projects-and-cycles.md |
| Teams, users, views, favorites |
teams-and-org.md |
| Import/export formats, duplicate creation, preview and partial-failure limits |
import-export.md |
| Attachment CRUD, authenticated upload downloads, URL extraction |
attachments-and-uploads.md |
| Watch events, temporary webhooks, notifications, metrics, history, time |
eventing-and-tracking.md |
| Raw GraphQL, pagination, documents |
advanced.md |
| Installation, auth, profiles, config paths, diagnostics, completions |
setup.md |
| Output handling, stdin, pagination, retries, safe chaining |
output-and-scripting.md |
| JSON shapes and command-specific limitations |
json-shapes.md |
| Auth errors, rate limits, partial results, missing commands, cache |
troubleshooting.md |
| Full command discovery and local verification |
command-surface.md |
1---2name: use-linear-cli3description: Use when driving Linear through linear-cli for issues, bulk operations, search, or git and PR workflows.4disable-model-invocation: true5metadata:6 source: https://skillmd.com/skills/yigitkonur/use-linear-cli7---89# Use linear-cli1011Drive [nesszer/linear-cli](https://github.com/nesszer/linear-cli), whose executable is `linear-cli`. This skill targets release **0.3.28**. Check `linear-cli --version`; use the installed command's help when versions differ.1213Read [live compatibility](references/live-compatibility.md) before using remote templates, time tracking, or bulk previews.1415## Workflow16171. **Discover unfamiliar commands/flags** through the installed command’s `--help`. [command-surface.md](references/command-surface.md) indexes the public tree. Global flag acceptance does not prove handler support.182. **Verify identity once per session and after profile changes** with `linear-cli u me --output json`. `auth status --validate` can exit 0 without validated credentials; see [setup.md](references/setup.md) for auth precedence.193. **Resolve scope.** Resolve team keys, assignees, labels, workflow states, project names, and issue identifiers from actual data. Never pick the first team or invent IDs. Respect the user's chosen tool and workspace.204. **Read before changing.** Fetch current values and the exact target set. For generated bulk sets, save and inspect IDs, count them, and preview the intended changes. Use `--dry-run` where supported; its coverage differs by command. Keep the concrete target set within the user’s authorization.215. **Execute and reconcile.** Capture successful IDs and per-item results. Re-read changed resources. Partial failures are not transactions: restore a previous value only if it was captured and the follow-up change is authorized.2223## Output rules2425- Request `--output json` for structured results, and keep stdout and stderr separate. Runtime JSON errors go to **stderr**; parser failures are plain text. Some handlers still emit prose or no JSON.26- Use `--id-only` only on handlers that implement it, such as issue create/update. `i list --id-only` does not produce a plain ID list; extract identifiers from JSON with `jq`.27- Set `LINEAR_CLI_NO_PAGER=true` in agent runs. Use `--yes` or a command's `--force` only for an authorized operation; there is no global `-y` alias.2829## Common reads3031```bash32linear-cli --version33linear-cli u me --output json34linear-cli t list --output json35linear-cli i list --mine -t ENG --output json --fields identifier,title,state.name36linear-cli i get LIN-123 --output json37linear-cli context --output json38```3940`ENG` and `LIN-123` are placeholders to replace with resolved values. `i list` defaults to a limited page and does not filter to open issues. `i get LIN-1 LIN-2` performs concurrent per-ID requests; JSON results may be sorted and partial failures still exit nonzero.4142## Route to the task4344Read only the relevant reference. Bash recipes use Bash syntax; the checklist recipes support macOS's Bash 3.2.4546| Task | Reference |47|---|---|48| Checklist, CSV, JSON, template, or parent/child bulk creation | [creating-many-issues.md](references/recipes/creating-many-issues.md) |49| Start work, create a GitHub PR, branch context, jj, stop work | [git-and-pr-loop.md](references/recipes/git-and-pr-loop.md) |50| Triage queue, comments, screenshots, attachments | [triage-and-comments.md](references/recipes/triage-and-comments.md) |51| Issue create/update, JSON input, transitions, move/transfer, archive/delete | [lifecycle.md](references/issues/lifecycle.md) |52| Search/list filters, saved views, favorites | [search-and-filter.md](references/issues/search-and-filter.md) |53| Relations, labels, statuses, local and remote templates | [relations-and-labels.md](references/issues/relations-and-labels.md) |54| Projects, updates, cycles, sprints, milestones, roadmaps, initiatives | [projects-and-cycles.md](references/planning/projects-and-cycles.md) |55| Teams, users, views, favorites | [teams-and-org.md](references/planning/teams-and-org.md) |56| Import/export formats, duplicate creation, preview and partial-failure limits | [import-export.md](references/data/import-export.md) |57| Attachment CRUD, authenticated upload downloads, URL extraction | [attachments-and-uploads.md](references/data/attachments-and-uploads.md) |58| Watch events, temporary webhooks, notifications, metrics, history, time | [eventing-and-tracking.md](references/eventing-and-tracking.md) |59| Raw GraphQL, pagination, documents | [advanced.md](references/advanced.md) |60| Installation, auth, profiles, config paths, diagnostics, completions | [setup.md](references/setup.md) |61| Output handling, stdin, pagination, retries, safe chaining | [output-and-scripting.md](references/output-and-scripting.md) |62| JSON shapes and command-specific limitations | [json-shapes.md](references/json-shapes.md) |63| Auth errors, rate limits, partial results, missing commands, cache | [troubleshooting.md](references/troubleshooting.md) |64| Full command discovery and local verification | [command-surface.md](references/command-surface.md) |
