# Linearite

> CLI tool for creating Linear issues and checking velocity rankings

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

---


## Setup

Requires `LINEAR_API_KEY` environment variable:

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

## Commands

### Create an Issue

```bash
linearite create "Issue title" --team-id <TEAM_ID> [--description "..."] [--project-id <PROJECT_ID>]
```

Short flags: `-t` (team), `-d` (description), `-p` (project)

Output includes the issue URL and suggested git branch name.

### Discovery

```bash
linearite list-teams     # Get team IDs
linearite list-projects  # Get project IDs
```

### Velocity Rankings

```bash
linearite rank-teams [--since 14d] [--top 10]
linearite rank-users [--since 14d] [--top 10]
```

`--since` accepts: `7d`, `30d`, `2025-01-01`, or ISO 8601 dates.

## Workflows

### Quick Issue Creation

1. Find the team ID: `linearite list-teams`
2. Create: `linearite create "Fix auth bug" -t <TEAM_ID> -d "Users getting logged out after 5 minutes"`

### Sprint Velocity Check

```bash
linearite rank-users --since 14d --top 5
```

### Assign to Project

```bash
linearite list-projects
linearite create "New feature" -t <TEAM_ID> -p <PROJECT_ID>
```

## Notes

- Only completed issues with estimates count toward velocity rankings
- Branch names are auto-generated by Linear, not this CLI
- All commands require valid API key in environment