# linear-cli
> Manage Linear issues from the command line

## 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

## When to Use
- 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

## When NOT to Use
- You don't use Linear.app for project management
- You need a full-featured project management GUI
- 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

## Installation
- **homebrew**: `brew install schpet/tap/linear`

---
Source: https://littlescripts.sh/tools/linear-cli