Linear CLI Skill — Development skill for Claude Code

Linear CLI Skill

A Claude skill that provides a lightweight CLI for working with Linear issues. Written in JavaScript with minimal dependencies (only Linear SDK and dotenv).

Following GitHub CLI conventions for consistency and ease of use.

What's included

• linear/ - Standalone CLI tool with minimal dependencies
• linear/SKILL.md - Claude skill documentation for using the CLI
• .claude-plugin/marketplace.json - Marketplace definition for easy installation in Claude
• Plans/ - Implementation planning documents

Installation in Claude

Install this skill in Claude Code using the plugin marketplace:

claude plugin marketplace add Valian/linear-cli-skill
claude plugin install linear

The skill will then be available for working with Linear issues directly through Claude.

Installation

Dependencies are automatically installed on first run. If you want to install manually:

cd linear/
npm install

Setup

Get your Linear API key:

1. Go to https://linear.app/settings/api
2. Navigate to Settings > API > Personal API keys
3. Click "Create key"

Provide your API key in one of these ways:

Option 1: Environment variable (temporary)

export LINEAR_API_KEY="your-api-key"

Option 2: .env file (persistent, recommended)

Create a `.env` file next to the `linear` executable:

echo 'LINEAR_API_KEY=your-api-key' > linear/.env

Or create it manually:

# linear/.env
LINEAR_API_KEY=your-api-key

Quick Start

# Setup API key
echo 'LINEAR_API_KEY=your-api-key' > linear/.env

# Run the CLI
./linear/linear team list
./linear/linear issue list --limit 5

Usage

Run the CLI using the `linear` executable:

./linear/linear   [arguments] [options]

Or via npm from the `linear/` directory:

cd linear/
npm run cli --   [arguments] [options]

Resources

...