linear

Manage Linear issues via GraphQL from a TypeScript CLI.

327|85|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/letta-ai/lettabot --skill linear-letta-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/letta-ai/lettabot/tree/main/.skills/linear
Command: npx skills add https://github.com/letta-ai/lettabot --skill linear-letta-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill enables CLI-driven management of Linear issues through the GraphQL API, enabling rapid triage, updates, and collaboration without leaving your terminal.

Core Features & Use Cases

  • List and filter issues by state or assignee to quickly surface the right items.
  • Get details, update priorities, and change states on issues to reflect progress.
  • Comment and search for context, speeding up backlog grooming and sprint planning.
  • Use Case: A developer triages Backlog items, assigns them to teammates, and tracks progress from a single command line.

Quick Start

To start using this skill, run the following commands:

  • npx tsx scripts/linear.ts list --state "Backlog"
  • npx tsx scripts/linear.ts get <issue-id>
  • npx tsx scripts/linear.ts update <issue-id> --priority 2 --state "In Progress"
  • npx tsx scripts/linear.ts comment <issue-id> "Context update"
  • npx tsx scripts/linear.ts search "error in login"

Frequently Asked Questions about linear

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Linear issues from the command line?

You can manage Linear issues from the command line by running a TypeScript script that sends GraphQL queries and mutations to the Linear API. This allows you to list, update, and triage issues directly from your terminal.

Can I filter and list Linear issues by state or assignee via CLI?

Yes, you can filter and list Linear issues by state or assignee via CLI. The script supports commands to quickly surface specific items, enabling rapid backlog grooming and sprint planning without leaving the terminal.

Do I need a LINEAR_API_KEY to update issue priorities and states in the terminal?

Yes, you need a LINEAR_API_KEY to update issue priorities and states in the terminal. The TypeScript script requires this key to authenticate GraphQL mutations and apply changes like priority updates or state transitions to your issues.

What is the best way to triage a Linear backlog without leaving the terminal?

The best way to triage a Linear backlog without leaving the terminal is using a CLI script that executes GraphQL commands. It allows developers to search issues, add comments, and reassign tasks for rapid collaboration and progress tracking.

How does searching and commenting on Linear issues work through GraphQL?

Searching and commenting on Linear issues through GraphQL works by executing specific CLI commands that send queries and mutations to the Linear API. This allows you to search for context and post comments directly to issues for backlog grooming.