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
- Find the team ID:
linearite list-teams - 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