linear · git:20260421.5447c37 · 2026-04-21 · sha256 c438edcff7ce089e

linear git:20260421.5447c37A

Immutable. This exact content never changes and is served at /api/v1/blob/c438edcff7ce089e.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_zx6sx25gjvalfhhf/c438edcff7ce089eb51f67716eb618235dffa252d29dc07dee5577a071f3bf97.json

Then /plugin install linear@markdownregistry-zx6sx25gjvalfhhf in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
name: linear
description: Manage Linear issues, projects, and workflows via CLI. This skill should be used when the user wants to create, list, update, or search Linear issues, manage projects or milestones, or interact with their Linear workspace. Triggers on "create a task", "add a Linear issue", "list my issues", "update GLE-123", "what's in my backlog", or any Linear-related request.
---

# Linear CLI

Standalone CLI for the Linear issue tracker. Zero dependencies beyond Python 3.

## Setup

On first use, authenticate with a Linear personal API key (generate at Linear Settings > API):

```bash
linear auth lin_api_XXXX
```

The key is stored at `~/.config/linear/api_key` with `0600` permissions. Alternatively, set `LINEAR_API_KEY` env var.

The CLI script is bundled at `scripts/linear` within this skill directory. Execute it directly or reference its absolute path.

## Commands

### Create an issue

```bash
linear create "Issue title" \
  --team GLE \
  --state Todo \
  --assignee me \
  --due today \
  --priority high \
  --description "Markdown description" \
  --label "Bug"
```

Priority: `urgent`, `high`, `medium`, `low`, `none` (or 0-4).

Due date: `YYYY-MM-DD`, `today`, `tomorrow`.

### List issues

```bash
linear list --mine --status "In Progress"
linear list --team GLE --status Todo --limit 10
linear list --priority high --json
```

### Show issue details

```bash
linear show GLE-123
linear show GLE-123 --json
```

### Update an issue

```bash
linear update GLE-123 --state "In Progress"
linear update GLE-123 --priority urgent --due 2026-05-01
linear update GLE-123 --assignee me --title "New title"
```

### Add a comment

```bash
linear comment GLE-123 "This is done, merging now"
```

### Workspace info

```bash
linear teams
linear me
linear statuses --team GLE
linear labels --team GLE
```

## Conventions

- Use team key (e.g. `GLE`), not full team name, in `--team` flags.
- Default assignee: `me` unless specified otherwise.
- Default state for new issues: `Todo`.
- Use `--due today` for same-day tasks.
- The CLI outputs human-readable text by default; pass `--json` for machine-readable output.
- When creating issues from conversation context, write a concise title and structured markdown description.