Linear CLI Skill

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

undefined

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:

undefined

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

...