linear – OpenClaw Skill

---

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

# 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.

Linear Skill for Clawdbot

A Clawdbot skill for managing Linear issues directly from your AI assistant.

Features

• List assigned issues or team issues
• Create, update, and search issues
• Change issue status, assignee, and priority
• Add comments to issues
• List teams, workflow states, and users

Installation

From ClawdHub

clawdhub install linear

Manual

Clone into your Clawdbot skills directory:

git clone https://github.com/mrklnc/clawdbot-skill-linear.git ~/.clawdbot/skills/linear

Setup

1. Get a Linear API key from linear.app/settings/api

2. Store it in ~/.clawdbot/credentials/linear.json:

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

   Or set the LINEAR_API_KEY environment variable.

Usage Examples

Once installed, just ask your Clawdbot:

• "Show me my Linear issues"
• "Create a bug report for the login page"
• "Move CLP-123 to In Progress"
• "What's the status of the auth refactor?"
• "Add a comment to CLP-456 saying it's fixed"

Commands

Command	Description
issues --mine	List your assigned issues
issues --team ID	List issues for a team
get ISSUE	Get issue details
search "query"	Search issues
create --team ID --title "..."	Create an issue
update ISSUE --state ID	Update an issue
comment ISSUE "text"	Add a comment
teams	List teams
states	List workflow states
users	List workspace users

Use --json for raw API output.

License

MIT