linear-cli 0.3.21

A powerful CLI for Linear.app - manage issues, projects, cycles, and more from your terminal
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

---
name: linear-pr
description: Create GitHub PRs linked to Linear issues. Use when creating pull requests, pushing code for review, or linking PRs to Linear issues.
allowed-tools: Bash
---

# Linear PR Creation

Create GitHub pull requests linked to Linear issues using `linear-cli`.

## Create PR

```bash
# Create PR linked to Linear issue
linear-cli g pr LIN-123

# Draft PR
linear-cli g pr LIN-123 --draft

# Specify base branch
linear-cli g pr LIN-123 --base main

# Open in browser after creation
linear-cli g pr LIN-123 --web
```

## Git Branch Operations

```bash
# Create and checkout branch for issue
linear-cli g checkout LIN-123

# Custom branch name
linear-cli g checkout LIN-123 -b my-custom-branch

# Just show branch name (don't create)
linear-cli g branch LIN-123

# Create branch without checkout
linear-cli g create LIN-123
```

## Complete Workflow

```bash
# 1. Start work (assigns, sets In Progress, creates branch)
linear-cli i start LIN-123 --checkout

# 2. Make changes and commit
git add . && git commit -m "Fix the bug"

# 3. Create PR
linear-cli g pr LIN-123

# 4. Mark done
linear-cli i update LIN-123 -s Done
```

## Get Current Issue

```bash
# Get issue from current git branch
linear-cli context
linear-cli context --output json
```

## Tips

- PR title/description auto-generated from issue
- Use `--draft` for work-in-progress
- Branch pattern: `username/lin-123-issue-title`
- Requires `gh` CLI for GitHub operations