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

---
name: linear-uploads
description: Download attachments and images from Linear issues. Use when fetching screenshots, images, or file attachments from Linear comments or descriptions.
allowed-tools: Bash Read
---

# Linear Uploads

Download attachments and images from Linear issues using `linear-cli`.

## Download to File

```bash
# Download image/attachment to file
linear-cli up fetch "https://uploads.linear.app/..." -f image.png

# Download to temp directory
linear-cli up fetch "https://uploads.linear.app/..." -f /tmp/screenshot.png
```

## Output to Stdout

```bash
# Pipe to other tools
linear-cli up fetch "https://uploads.linear.app/..." | base64

# Redirect to file
linear-cli up fetch "https://uploads.linear.app/..." > file.png
```

## Finding Upload URLs

Upload URLs are found in:
- Issue descriptions (`linear-cli i get LIN-123 --output json`)
- Comments (`linear-cli cm list LIN-123 --output json`)

URL pattern: `https://uploads.linear.app/{org}/{upload}/{filename}`

## View Images (AI Agents)

Since Claude is multimodal, download then read:

```bash
# 1. Download to temp file
linear-cli up fetch "https://uploads.linear.app/..." -f /tmp/screenshot.png

# 2. Use Read tool on the file
# Claude can view images directly
```

## Tips

- Requires valid LINEAR_API_KEY
- Use `-f` / `--file` to specify output filename
- Without `-f`, outputs raw bytes to stdout
- URLs must be from `uploads.linear.app`