| name | linear |
| description | Interact with Linear for issue tracking. Use when creating, updating, listing, or searching issues. Supports viewing assigned issues, changing status, adding comments, and managing tasks. |
Linear
Manage Linear issues via scripts/linear.sh.
Setup
Store API key in ~/.clawdbot/credentials/linear.json:
{"apiKey": "lin_api_..."}
Commands
scripts/linear.sh issues --mine
scripts/linear.sh issues --team TEAM_ID
scripts/linear.sh get CLP-123
scripts/linear.sh search "auth bug"
scripts/linear.sh create --team TEAM_ID --title "Bug: login fails" --description "Details"
scripts/linear.sh update CLP-123 --state STATE_ID
scripts/linear.sh comment CLP-123 "Fixed in PR #42"
scripts/linear.sh teams
scripts/linear.sh states
scripts/linear.sh users
Use --json flag for raw API output: scripts/linear.sh --json issues --mine
Workflow Examples
Create and assign a bug:
scripts/linear.sh teams
scripts/linear.sh create --team abc123 --title "Critical: API down" --priority 2
Move issue to In Progress:
scripts/linear.sh states
scripts/linear.sh update CLP-45 --state xyz789
See references/api-examples.md for GraphQL details.