home / skills / trevors / dot-claude / linear-cli

linear-cli skill

safe

This skill helps you query, create, and manage Linear issues from the terminal, boosting productivity by simplifying issue handling directly in CLI.

npx playbooks add skill trevors/dot-claude --skill linear-cli

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

1.2 KB

---
name: Linear CLI
description: Query, create, and manage Linear issues from the command line. Use when checking assigned work, viewing issue details, creating new issues, or updating issue status.
---

# Linear CLI

Query, create, and update Linear issues without leaving the terminal.

## Quick Examples

```bash
# Check your assigned work
linear-cli my-work

# View issue details
linear-cli issue ENG-456

# Create a new issue
linear-cli create --title "Production bug" --priority 1 --team ENG

# Update status and add comment
linear-cli update ENG-456 --status "Done"
linear-cli comment ENG-456 "Shipped in v2.1.0"
```

## Key Flags

- `--team ENG` - Specify or filter by team
- `--status "In Progress"` - Set or filter by status
- `--priority 1` - Set priority (1-4, 1 is highest)
- `--assignee name` - Assign to team member
- `--description` - Add issue description

## More Info

See REFERENCE.md for complete flag documentation, advanced examples, and workflow patterns. Use `linear-cli --help` or `linear-cli <command> --help` for all options.

## Authentication

```bash
linear-cli login    # OAuth login (stores credentials)
linear-cli logout   # Clear stored credentials
linear-cli status   # Verify connection
```

Overview

This skill lets you query, create, and manage Linear issues directly from the command line. It streamlines common Linear workflows—checking assigned work, viewing issue details, creating new issues, and updating status—without opening the web UI. Authentication is handled via CLI login to securely store credentials.

How this skill works

The CLI issues GraphQL requests to Linear on your behalf after authenticating via OAuth and storing credentials locally. Commands include listing assigned work, inspecting an issue by key, creating issues with flags for team, priority, assignee, and description, and updating status or adding comments. Use built-in help for command-specific flags and examples.

When to use it

Quickly check your current assigned work from a terminal or during a coding session
Create a new issue while reproducing a bug or capturing a task without switching contexts
Update issue status or add comments after finishing a task or reviewing PRs
Filter or view issues by team, status, priority, or assignee from scripts or automation
Verify your CLI connection and credentials before running commands

Best practices

Authenticate with linear-cli login and verify using linear-cli status before regular use
Use the --team, --status, and --priority flags to keep created issues consistent with team workflow
Include concise descriptions and use comments for release notes or deployment references
Automate repetitive queries in shell scripts or CI steps for lightweight reporting
Run linear-cli <command> --help to discover available flags and examples

Example use cases

Check assigned tasks: linear-cli my-work to see what you need to tackle today
Create a bug while debugging: linear-cli create --title "Production bug" --priority 1 --team ENG --description "Steps to reproduce..."
Update progress: linear-cli update ENG-456 --status "In Progress" after starting work
Add a release note: linear-cli comment ENG-456 "Shipped in v2.1.0" after deployment
Filter team board: linear-cli list --team ENG --status "In Progress" to review current sprint work

FAQ

How do I authenticate the CLI?

Run linear-cli login to start OAuth authentication. The CLI stores credentials locally. Use linear-cli status to verify the connection and linear-cli logout to clear credentials.

How do I find available flags and commands?

Use linear-cli --help or linear-cli <command> --help to display command-specific flags, examples, and usage patterns.