Linear

Manage Linear issues via scripts/linear.sh.

Setup

Store API key in ~/.clawdbot/credentials/linear.json:

{"apiKey": "lin_api_..."}

Commands

# List my assigned issues
scripts/linear.sh issues --mine

# List team issues
scripts/linear.sh issues --team TEAM_ID

# Get issue details
scripts/linear.sh get CLP-123

# Search issues
scripts/linear.sh search "auth bug"

# Create issue
scripts/linear.sh create --team TEAM_ID --title "Bug: login fails" --description "Details"

# Update issue (status, title, assignee, priority)
scripts/linear.sh update CLP-123 --state STATE_ID

# Add comment
scripts/linear.sh comment CLP-123 "Fixed in PR #42"

# List teams (to get TEAM_ID)
scripts/linear.sh teams

# List states (to get STATE_ID)
scripts/linear.sh states

# List users (to get assignee ID)
scripts/linear.sh users

Use --json flag for raw API output: scripts/linear.sh --json issues --mine

Workflow Examples

Create and assign a bug:

# Find team ID
scripts/linear.sh teams
# Create with priority 2 (high)
scripts/linear.sh create --team abc123 --title "Critical: API down" --priority 2

Move issue to In Progress:

# Find state ID
scripts/linear.sh states
# Update
scripts/linear.sh update CLP-45 --state xyz789

See references/api-examples.md for GraphQL details.