# Linear

> Interact with Linear project management. Use for creating, searching, updating issues and projects. Triggers on "linear", "issue", "ticket", "task", "backlog", "sprint", "cycle", or project management requests.

- Skill: `diegosouzapw/linear-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/linear-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/linear-3/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/diegosouzapw/linear-3

---


# Linear Integration

Query and manage Linear issues, projects, and teams via the Linear SDK.

## Setup

Requires `LINEAR_API_KEY` in your Moltbot config env section:
```json
"env": {
  "LINEAR_API_KEY": "lin_api_..."
}
```

## Usage

Run scripts from this skill's `scripts/` directory:

### List Issues
```bash
LINEAR_API_KEY="$LINEAR_API_KEY" node scripts/linear.mjs issues [--limit N] [--team TEAM_ID]
```

### Search Issues
```bash
LINEAR_API_KEY="$LINEAR_API_KEY" node scripts/linear.mjs search "query text" [--limit N]
```

### Get Issue by ID
```bash
LINEAR_API_KEY="$LINEAR_API_KEY" node scripts/linear.mjs get ISSUE_ID
```

### Create Issue
```bash
LINEAR_API_KEY="$LINEAR_API_KEY" node scripts/linear.mjs create --title "Title" --team TEAM_ID [--description "..."] [--priority 1-4]
```

### Update Issue
```bash
LINEAR_API_KEY="$LINEAR_API_KEY" node scripts/linear.mjs update ISSUE_ID [--title "..."] [--state STATE_ID] [--priority 1-4]
```

### List Teams
```bash
LINEAR_API_KEY="$LINEAR_API_KEY" node scripts/linear.mjs teams
```

### List Projects
```bash
LINEAR_API_KEY="$LINEAR_API_KEY" node scripts/linear.mjs projects
```

## Output

All commands output JSON for easy parsing. Use `jq` for formatting if needed.

## Priority Levels
- 0: No priority
- 1: Urgent
- 2: High
- 3: Medium
- 4: Low