linear
# Linear
Interact with Linear directly via the Linear GraphQL API (`api.linear.app/graphql`).
## Setup (one-time)
1. Go to Linear → Settings → Account → Security & Access → API keys
2. Create a new key
3. Set environment variable:
```
LINEAR_API_KEY=lin_api_...
```
## Usage
### List your teams
```bash
python3 /mnt/skills/user/linear/scripts/linear_query.py teams
```
### List issues assigned to you
```bash
python3 /mnt/skills/user/linear/scripts/linear_query.py my-issues
python3 /mnt/skills/user/linear/scripts/linear_query.py my-issues --state "In Progress"
```
### List issues for a team
```bash
python3 /mnt/skills/user/linear/scripts/linear_query.py issues --team "Engineering"
python3 /mnt/skills/user/linear/scripts/linear_query.py issues --team "Engineering" --state "Todo" --limit 20
```
### Get a specific issue
```bash
python3 /mnt/skills/user/linear/scripts/linear_query.py issue ENG-123
```
### Search issues
```bash
python3 /mnt/skills/user/linear/scripts/linear_query.py search "authentication bug"
```
### Create an issue
```bash
python3 /mnt/skills/user/linear/scripts/linear_query.py create --team "Engineering" --title "Fix login bug" --description "Users can't log in on Safari"
python3 /mnt/skills/user/linear/scripts/linear_query.py create --team "Engineering" --title "Add dark mode" --priority 2
```
### Update an issue
```bash
python3 /mnt/skills/user/linear/scripts/linear_query.py update ENG-123 --state "Done"
python3 /mnt/skills/user/linear/scripts/linear_query.py update ENG-123 --priority 1 --title "New title"
```
### List projects
```bash
python3 /mnt/skills/user/linear/scripts/linear_query.py projects
python3 /mnt/skills/user/linear/scripts/linear_query.py projects --team "Engineering"
```
### List cycles (sprints)
```bash
python3 /mnt/skills/user/linear/scripts/linear_query.py cycles --team "Engineering"
```
### List workflow states for a team
```bash
python3 /mnt/skills/user/linear/scripts/linear_query.py states --team "Engineering"
```
## Priority levels
- 0 = No priority
- 1 = Urgent
- 2 = High
- 3 = Normal
- 4 = Low
标签
skill
ai
