← Back to tools

linear-cli

Manage Linear issues from the command line

Productivity Development linuxmacoswindows TypeScript ISC

Description

linear-cli is a command-line interface for the Linear issue tracker that lets you list, start, and create issues without leaving the terminal. It is git-aware and jj-aware, automatically keeping you in the right views in Linear based on your current branch. Supports creating branches from issues, managing issue status, adding comments, and integrating with GitHub PRs via the gh CLI. Designed to work well with AI coding agents.

Install

homebrewbrew install schpet/tap/linear

AI Summary

A git-aware CLI for Linear issue tracking that integrates branch management, issue lifecycle, and GitHub PR workflows from the terminal.

Capabilities

  • + List, view, and create Linear issues from the terminal
  • + Start issues with automatic branch creation
  • + Manage issue status, comments, and assignments
  • + Integrate with GitHub PRs via the gh CLI
  • + Team, project, milestone, and document management
  • + Git and jj version control awareness for contextual views
  • + Works with AI coding agents like Claude Code

Use When

  • You use Linear for issue tracking and want terminal-based workflows
  • You want to create branches from Linear issues automatically
  • You want to manage Linear issues alongside your code without switching to the browser

Avoid When

  • x You don't use Linear.app for project management
  • x You need a full-featured project management GUI
  • x You need offline issue tracking

Usage Patterns

List your assigned issues

linear issue list

Shows issues assigned to you in the current team context

Start working on an issue

linear issue start ISSUE-ID

Sets the issue to in-progress and creates a git branch

View AGENTS.md for linear-cli