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 "Engineerin...

# linear

An [OpenClaw](https://clawhub.ai) skill for querying and managing Linear issues, projects, cycles, and teams — directly via `api.linear.app`, no third-party proxy.

## What it does

List and create issues, search across your workspace, manage projects and cycles, and update issue states — all by team name, no ID lookup required.

## Setup

**1. Create an API key**

Go to Linear → Settings → Account → Security & Access → API keys.

**2. Set the environment variable**

```bash
export LINEAR_API_KEY=lin_api_...
```

## Supported operations

| Resource | List | Get | Create | Update | Search |
|---|---|---|---|---|---|
| issues | ✅ | ✅ | ✅ | ✅ | ✅ |
| projects | ✅ | | | | |
| cycles | ✅ | | | | |
| teams | ✅ | | | | |
| states | ✅ | | | | |

## Usage

### Teams & states

```bash
python3 scripts/linear_query.py teams
python3 scripts/linear_query.py states --team "Engineering"
```

### Issues

```bash
# Your assigned issues
python3 scripts/linear_query.py my-issues
python3 scripts/linear_query.py my-issues --state "In Progress"

# Team issues
python3 scripts/linear_query.py issues --team "Engineering"
python3 scripts/linear_query.py issues --team "Engineering" --state "Todo"

# Specific issue
python3 scripts/linear_query.py issue ENG-123
```

### Search

```bash
python3 scripts/linear_query.py search "authentication bug"
```

### Create & update

```bash
python3 scripts/linear_query.py create --team "Engineering" --title "Fix login bug" --description "Fails on Safari" --priority 2
python3 scripts/linear_query.py update ENG-123 --state "Done"
python3 scripts/linear_query.py update ENG-123 --priority 1 --title "New title"
```

### Projects & cycles

```bash
python3 scripts/linear_query.py projects
python3 scripts/linear_query.py projects --team "Engineering"
python3 scripts/linear_query.py cycles --team "Engineering"
```

## Priority levels

| Value | Label |
|---|---|
| 0 | No priority |
| 1 | Urgent |
| 2 | High |
| 3 | Normal |
| 4 | Low |

## Requirem...