How do I install the Linear CLI skill?

Run npx skillmds@latest add injectivelabs/linear-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Linear CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Linear CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Linear CLI free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

Who published Linear CLI?

injectivelabs (@injectivelabs) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Linear CLI by injectivelabs — Agent Skill

Name: Linear CLI
Author: injectivelabs

File contents

Linear CLI, Skill Guide

Overview

Use the linear CLI to manage Linear issues, teams, and projects from the terminal. Prefer CLI flows over raw GraphQL when a command exists.

Quick Start

Verify the CLI is available: linear --version.
Install the CLI if needed (see Install Linear CLI).
Configure the API key and repo settings (see Configure API Key).
Use linear issue list, linear issue start, and linear issue view for day-to-day workflows.

Install Linear CLI

Prefer NPM-distributed version from Injective Labs:

npm i -g @injectivelabs/linear-cli

One-time commands can be run via npx @injectivelabs/linear-cli.

If NPM is not available

Fetch binary for current platform using https://github.com/InjectiveLabs/linear-cli/releases/latest install it so it available in $PATH.

Configure API Key

Create a personal API key in Linear account settings: https://linear.app/settings/account/security.
If linear auth login exists, run it to authenticate. Otherwise export the key for the CLI session: export LINEAR_API_KEY=....
Run linear config inside the repo to generate .linear.toml interactively.
Use linear auth token or linear auth whoami to verify authentication.
Note: API key creation requires member access (not guest).

Common Workflows

List issues: linear issue list with filters like --state, --assignee, --team, or --limit.
Start work on an issue: linear issue start ABC-123 (use -b to specify a branch).
View an issue: linear issue view ABC-123 (use -w for web or -a for app).
Create an issue: linear issue create --title "..." --team TEAM (add --project, --label, --priority, or --estimate as needed).
Update an issue: linear issue update ABC-123 --state STATE --assignee USER.
Add a comment: linear issue comment add ABC-123 --body "...".
Browse teams/projects: linear team list, linear project list, then linear project view.

Command Reference

Instead of guessing flag and command arguments, check the reference.

See references/commands.md for the full command and flag list extracted from linear completions bash.

When some command feels missing try npx @injectivelabs/linear-cli@latest completions bash to refresh the completions.

Safety

Confirm destructive actions explicitly before running linear issue delete.
Avoid raw schema dumps unless needed; prefer regular commands to inspect data.

---name: linear-clidescription: Enables management of Linear issues, teams, projects, comments, or configuration via the `linear` CLIlicense: Apache-2.0---# Linear CLI, Skill Guide## OverviewUse the `linear` CLI to manage Linear issues, teams, and projects from the terminal. Prefer CLI flows over raw GraphQL when a command exists.## Quick Start1. Verify the CLI is available: `linear --version`.2. Install the CLI if needed (see Install Linear CLI).3. Configure the API key and repo settings (see Configure API Key).4. Use `linear issue list`, `linear issue start`, and `linear issue view` for day-to-day workflows.## Install Linear CLIPrefer NPM-distributed version from Injective Labs:```bashnpm i -g @injectivelabs/linear-cli```One-time commands can be run via `npx @injectivelabs/linear-cli`.### If NPM is not availableFetch binary for current platform using <https://github.com/InjectiveLabs/linear-cli/releases/latest> install it so it available in `$PATH`.## Configure API Key- Create a personal API key in Linear account settings: `https://linear.app/settings/account/security`.- If `linear auth login` exists, run it to authenticate. Otherwise export the key for the CLI session: `export LINEAR_API_KEY=...`.- Run `linear config` inside the repo to generate `.linear.toml` interactively.- Use `linear auth token` or `linear auth whoami` to verify authentication.- Note: API key creation requires member access (not guest).## Common Workflows- List issues: `linear issue list` with filters like `--state`, `--assignee`, `--team`, or `--limit`.- Start work on an issue: `linear issue start ABC-123` (use `-b` to specify a branch).- View an issue: `linear issue view ABC-123` (use `-w` for web or `-a` for app).- Create an issue: `linear issue create --title "..." --team TEAM` (add `--project`, `--label`, `--priority`, or `--estimate` as needed).- Update an issue: `linear issue update ABC-123 --state STATE --assignee USER`.- Add a comment: `linear issue comment add ABC-123 --body "..."`.- Browse teams/projects: `linear team list`, `linear project list`, then `linear project view`.## Command ReferenceInstead of guessing flag and command arguments, check the reference.See `references/commands.md` for the full command and flag list extracted from `linear completions bash`.When some command feels missing try `npx @injectivelabs/linear-cli@latest completions bash` to refresh the completions.## Safety- Confirm destructive actions explicitly before running `linear issue delete`.- Avoid raw schema dumps unless needed; prefer regular commands to inspect data.

Frequently asked questions

Linear CLI