linearite

name	linearite
description	CLI tool for creating Linear issues and checking velocity rankings

Setup

Requires LINEAR_API_KEY environment variable:

export LINEAR_API_KEY="lin_api_..."

Commands

Create an Issue

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

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

Velocity Rankings

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

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

Assign to Project

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