linear

# Linear

Manage Linear issues via `scripts/linear.sh`.

## Setup

Store API key in `~/.clawdbot/credentials/linear.json`:
```json
{"apiKey": "lin_api_..."}
```

## Commands

```bash
# 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:**
```bash
# 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:**
```bash
# Find state ID
scripts/linear.sh states
# Update
scripts/linear.sh update CLP-45 --state xyz789
```

See [references/api-examples.md](references/api-examples.md) for GraphQL details.

# Linear Skill for Clawdbot

A [Clawdbot](https://github.com/clawdbot/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

```bash
clawdhub install linear
```

### Manual

Clone into your Clawdbot skills directory:

```bash
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](https://linear.app/settings/api)

2. Store it in `~/.clawdbot/credentials/linear.json`:
   ```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