Linear Agent

# linear-agent

Full Linear project management via GraphQL API.

## What I do
- Create, update, and search issues
- Move issues through workflow states by name
- Manage cycles and sprints
- Summarize team backlogs in plain English
- Sync git commit messages to issue states (e.g. "fixes ENG-42")
- Create and manage projects
- Post comments on issues

## Setup
Requires LINEAR_API_KEY environment variable.
Get your key at: Linear → Settings → Security & Access → API Keys
Set your Linear API key:
```
LINEAR_API_KEY=lin_api_yourkey
```
Get your key at: Linear → Settings → Security & Access → API Keys

## Usage
Works as both an OpenClaw skill and standalone CLI:
```
node index.js list-teams
node index.js create-issue --title "My issue" --teamId ENG
node index.js backlog-summary --teamId ENG
```

# linear-agent

> OpenClaw skill for full Linear project management via GraphQL API.

Create and update issues, manage cycles/sprints, search your backlog, generate summaries, and sync issue states from git commits — all through a clean JSON interface that works as both a standalone CLI tool and an OpenClaw/ClawHub skill.

---

## Features

| Command | Description |
|---|---|
| `create-issue` | Create issues with title, description, priority, assignee, team |
| `update-issue` | Update status, priority, assignee, labels |
| `get-issue` | Fetch a single issue by UUID or identifier (e.g. `ENG-42`) |
| `list-issues` | Filter by team, cycle, assignee, status, priority |
| `search-issues` | Full-text relevance search |
| `move-issue` | Move an issue to a workflow state by name or ID |
| `list-states` | List all workflow states for a team |
| `list-teams` | List all teams in the workspace |
| `backlog-summary` | Plain-English summary of a team's open backlog |
| `get-cycle` | Fetch a cycle and all its issues |
| `list-cycles` | List sprints for a team (supports active-only filter) |
| `cycle-progress` | Completion stats + days remaining for a cycle |
| `create-project` | Create a new project |
| `update-project` | Update project state, lead, target date |
| `list-projects` | List projects, optionally filtered by team |
| `post-comment` | Post a markdown comment on any issue |
| `sync-commit` | Parse a git commit message and auto-close referenced issues |

---

## Requirements

- **Node.js ≥ 18** (uses built-in `https` and `fetch` — zero npm dependencies)
- A **Linear account** with API access

---

## Setup

### 1. Get your Linear API key

1. Open Linear → **Settings → API → Personal API keys**
2. Click **Create key**, give it a name, copy the value (`lin_api_...`)

### 2. Set the environment variable

```bash
export LINEAR_API_KEY=lin_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

Add this to your `~/.zshrc` or `~/.bashrc` to persist it.

### 3. Install / make executable

```b...