linear-cli Skill for Claude Code: Manage Linear Issues

Lets Claude read and change your Linear issues, comments and projects from the terminal with the linear CLI.

Installs: 15.1K; on skills.sh
Stars: 1K; on GitHub
Files: 20; besides SKILL.md
Updated: Oct 2026; last repo commit

linear-cli teaches Claude to use the linear command-line tool to manage Linear. It can query and list issues, create and update them, change state, assignee and labels, add comments with images, link issues, and work with projects, cycles, documents and initiatives.

The skill needs the linear CLI and a Linear API key. Install the CLI and the skill with the install box above, then run linear auth login. It can also create, delete and archive items in your workspace, so approve write commands.

Good for

Developers who live in the terminal and track work in Linear
Teams that want an agent to file, update and comment on issues
People who want branch-aware Linear commands in git or jj repos

Install linear-cli

Claude Code

Copy this prompt.

Install the linear-cli skill in Claude Code. Run this command:

brew install schpet/tap/linear

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Homebrew.

Do step 1, then one of the step 2 routes, not both. Then run linear auth login with a Linear API key, and linear config inside your repo. The README also documents npm, a shell installer and prebuilt binaries for the CLI. The plugin manifest lists only the linear-cli skill.

From the project README. Source.

What's in the skill

When it loads

Manage Linear issues from the command line using the linear cli. This skill allows automating linear management.

Sections in SKILL.md

Prerequisites
Common Tasks
Query issues with filters
List my issues
Create an issue
Update an issue's state, assignee, or labels
Create an issue or project from a template
Add a comment
Attach an image or screenshot so it is visible inline
Resolve or reopen comment threads
View an issue / get its URL
Close, delete, or archive an issue
Best Practices for Markdown Content
Summary
Details
Linear Markdown Features

Key facts

Author: schpet (repo owner)
Repo: schpet/linear-cli
Installs on skills.sh: 15,096
Repo stars: 1,030
License: ISC
Last repo commit: 2026-10-23
Files in the skill folder: 21 files including SKILL.md
Needs: the linear CLI and a Linear API key
Allowed tools: Bash(linear:*), Bash(curl:*)

What it includes

linear issue query with team, state, project, assignee and label filters
Searches across assignees and teams. linear issue list shows only your own issues.
Network · Query issues
linear issue create with a title, team and description file
Uses --description-file for markdown and --no-input so scripted runs fail instead of prompting.
Write · Create an issue
Change state, assignee, delegate and labels
Add, remove or replace labels, hand an issue to an agent, or unassign.
Write · Update an issue
Create issues and projects from a Linear template
Lists and views templates; flags override template values.
Write · Templates
Add, list, update, delete and resolve comment threads
Can attach an image so it shows inline in the comment.
Write · Comments
Details, JSON output and the issue URL
linear issue view, with --json for structured output.
Network · View an issue
Close with a state, delete to trash, archive rarely
Delete sends an issue to the trash, restorable in Linear for 30 days. The skill prefers closing or deleting over archiving.
Delete · Close, delete or archive
File flags for bodies, plain URLs for mentions, collapsible sections
Use --description-file and --body-file for multi-line markdown. Mention people with their plain Linear URL.
Markdown rules
Dedicated subcommands for each
The command list also covers labels, milestones, teams, users and project updates, with a reference file for each.
Write · Projects, cycles, documents, initiatives
Run GraphQL when no dedicated command fits
Also shows calling the API with curl and the key from linear auth token.
Network · linear api
Codes 0 to 5 and 130 explain failures
For example 3 is not found, 4 is authentication, and 5 is network or rate limit, where a create may already have happened.
Exit status

From the official docs

Permissions

Medium risk

With your API key, Claude can create, edit, delete and comment on anything you can in Linear. Approve write commands one at a time and keep the key out of your prompts.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can change and delete your Linear data
The skill covers create, update, delete, archive and comment commands, and linear api can run any GraphQL request your key allows. Approve write commands one at a time. github.com
The API key gives broad access
The key acts as you in the workspace. Keep it out of prompts, and do not let Claude print it with linear auth token. github.com
Public image uploads exist
The README says --public uploads raster images to a public.linear.app URL that anyone can read without signing in. Do not use it for private screenshots. github.com

Technical details

Talks to	Linear API (api.linear.app)
Sign-in and keys	linear auth login takes a Linear API key and, per references/auth.md, keeps it in the system keyring unless you pass --plaintext, which writes it to the credentials file. linear auth token prints the key.
Scopes	Linear API key (your own access)

Questions

What does the linear-cli skill do?

It teaches Claude to manage Linear with the linear command-line tool: query, create and update issues, comment, change state and labels, and work with projects, cycles, documents and initiatives.

Do I need an API key?

Yes. The README says to create an API key in Linear's account security settings and run linear auth login. You also need the linear CLI itself, which the install box covers.

Can it run without installing the CLI?

The SKILL.md says you can prefix commands with npx @schpet/linear-cli instead of installing linear globally. It still needs your API key.

Can it delete issues?

Yes. linear issue delete sends an issue to the trash, restorable in Linear for 30 days. The skill prefers closing or deleting over archiving. Approve delete commands yourself.

Does it work with git?

Yes. The README says the CLI reads the issue ID from your git branch name, or from a Linear-issue trailer in jj commits, so commands like linear issue view work without an ID.

Does it work in the Claude app?

This page offers no Claude app install. The skill runs the linear command in a terminal, and the install box covers Claude Code, Codex and the skills CLI.

Is it safe to install?

The skill itself is mostly markdown, but it allows Bash commands for linear and curl and uses your Linear API key. Claude can create, change and delete items in your workspace, so approve write commands.

Information

updated Nov 2, 2026

Repository: schpet/linear-cli
Folder: skills/linear-cli

schpet/linear-cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

linear-cli README · github.com
linear-cli plugin.json · github.com
linear-cli SKILL.md · github.com
linear-cli references/auth.md · github.com