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-webhooks
description: Manage webhooks - create, listen for events, rotate secrets. Use when setting up integrations or event listeners.
allowed-tools: Bash
---

# Webhooks

```bash
# List all webhooks
linear-cli wh list

# Create a webhook
linear-cli wh create https://example.com/hook --events Issue

# Get webhook details
linear-cli wh get WEBHOOK_ID

# Update a webhook
linear-cli wh update WEBHOOK_ID --url https://new-url.com

# Delete a webhook
linear-cli wh delete WEBHOOK_ID --force

# Rotate signing secret
linear-cli wh rotate-secret WEBHOOK_ID

# Listen for events locally (dev/testing)
linear-cli wh listen --port 9000
linear-cli wh listen --port 9000 --secret SIGNING_SECRET
```

## Subcommands

| Command | Purpose |
|---------|---------|
| `list` | List all webhooks |
| `get` | View webhook details |
| `create` | Create webhook |
| `update` | Update webhook |
| `delete` | Delete webhook |
| `rotate-secret` | Rotate signing secret |
| `listen` | Local event listener with HMAC verification |

## Flags

| Flag | Purpose |
|------|---------|
| `--events TYPE` | Event types to subscribe |
| `--port N` | Local listener port |
| `--secret KEY` | HMAC signing secret |
| `--output json` | JSON output |

## Exit Codes

`0`=Success, `1`=Error, `2`=Not found, `3`=Auth error