linear-cli

TrevorS's avatarfrom TrevorS

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.

⭐2stars🔀0forks📁View on GitHub🕐Updated Dec 29, 2025

When & Why to Use This Skill

The Linear CLI skill enables seamless management of Linear issues directly from the command line interface. It streamlines project management workflows by allowing users to query, create, and update tasks without switching context, making it an essential tool for developers and high-performance teams who prioritize efficiency and terminal-centric productivity.

Use Cases

  • Developer Workflow Integration: Quickly create and assign bug reports or feature requests immediately after identifying them during a coding session without leaving the terminal.
  • Daily Standup Preparation: Efficiently query assigned tasks and recent updates using the 'my-work' command to prepare for team syncs or track personal progress.
  • Automated Status Updates: Instantly update issue statuses, change priorities, or add progress comments following a successful deployment or code merge.
  • Team Coordination: Filter and view issues by team keys or specific assignees to monitor project health and identify bottlenecks in the development pipeline.
nameLinear CLI
descriptionQuery, 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

# Check your assigned work
linear-cli my-work

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

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

Key Flags

  • --team-key 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

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