About linear-webhooks
linear-webhooks is a skill for managing Linear webhooks through the `linear-cli` command line. It covers webhook lifecycle operations and provides a local listener with HMAC verification.
Key features
- 01List, view, create, update, and delete webhooks
- 02Rotate webhook signing secrets
- 03Listen for events locally with HMAC verification
- 04Select event types and output JSON
Use cases
- 01Review existing webhook configurations
- 02Subscribe an endpoint to issue events
- 03Receive and verify webhook events locally
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/linear-webhooksin Claude Code to confirm it loaded.
Details
From the project READMEWebhooks
# 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
Comments
Markdown supported