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
- •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
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