Dotfiles-nix linear-cli

Use when working with the Linear CLI (`linear`) to browse and manage

install

source · Clone the upstream repo

git clone https://github.com/not-matthias/dotfiles-nix

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/not-matthias/dotfiles-nix "$T" && mkdir -p ~/.claude/skills && cp -r "$T/modules/home/programs/cli-agents/shared/skills/linear-cli" ~/.claude/skills/not-matthias-dotfiles-nix-linear-cli && rm -rf "$T"

manifest: modules/home/programs/cli-agents/shared/skills/linear-cli/SKILL.md

source content

Linear CLI

Use this skill when the user asks to use or debug the

linear

command-line tool. Assume authentication is already configured.

Quick checks

linear --version
linear --help

Core workflows

1) Look up issues

List your issues with filters:

linear issue list --all-states --team <TEAM_KEY> --project <PROJECT_NAME> --limit 50
linear issue list --state started --state unstarted --label bug --updated-after 2026-01-01

View one issue (text or JSON):

linear issue view <ISSUE_ID>
linear issue view <ISSUE_ID> --json --no-comments

Structured issue queries:

linear issue query --help

2) Work with projects

linear project list --all-teams
linear project list --team <TEAM_KEY> --status "In Progress" --json
linear project view <PROJECT_ID>

3) Explore teams and cycles

linear team list
linear team members <TEAM_KEY>
linear cycle list --team <TEAM_KEY>
linear cycle view <CYCLE_REF>

4) Find labels and documents

linear label list --all
linear label list --team <TEAM_KEY> --json
linear document list --project <PROJECT_NAME> --limit 50
linear document list --issue <TEAM-123> --json
linear document view <DOCUMENT_ID>

5) Open items in Linear/web

linear issue view <ISSUE_ID> --web
linear project list --app
linear team list --web

6) Run raw GraphQL API queries

Inline query:

linear api 'query { viewer { id name email } }'

With variables and pagination:

linear api 'query($first:Int!,$after:String){ issues(first:$first, after:$after){ nodes { identifier title } pageInfo { hasNextPage endCursor } } }' \
  --variable first=50 \
  --paginate

Command discovery

linear issue --help
linear project --help
linear team --help
linear cycle --help
linear label --help
linear document --help
linear api --help