Linear CLI
Manage Linear issues without ever leaving your terminal. Create, update, filter, and collaborate on issues directly from the command line.
About Linear CLI
Linear CLI is a terminal-first interface for Linear, the issue tracker engineers actually open every day. If you live in your terminal — writing code, reviewing PRs, running CI — context-switching to a browser tab just to update an issue status is friction Linear's web app can't solve. Linear CLI closes that gap: create issues, update status, filter your queue, and move through cycles without leaving the command line.
The tool started inside Contra Collective's own delivery team. Our project managers were living in Linear; our engineers were living in vim and tmux; the gap between those two was costing everyone 30 minutes a day on ticket hygiene. We built Linear CLI to stop paying that tax, and it has since shipped on every client engagement the agency runs — which is also the bar for why anything ends up on this site.
Linear CLI is open source, Node-based, authenticated via OAuth against your Linear workspace, and cross-platform. Works equally with personal accounts, team workspaces, and enterprise Linear deployments. Zero telemetry, zero cloud dependencies beyond Linear's own API.
What It Does
Create, read, update, and close issues
Filter by assignee, status, priority, and label
Automatic branch naming from issue IDs
Cycle and project management
Team and workspace switching
Keyboard-driven workflow with fuzzy search
Rich terminal output with color and formatting
OAuth and API key authentication
Key Features
Create and update issues from terminal
View and filter your issue queue
Seamless Git integration
Team collaboration features
Built With
The technologies powering Linear CLI.
Why Linear CLI
Honest notes on the closest comparable tools and where Linear CLI differs.
Linear web app
The canonical experience. Best for triage, roadmap planning, and visual work — worst for the mid-coding context switch this tool exists to solve.
lr (community CLI)
Similar premise, narrower scope. Covers basic issue list and create. Linear CLI adds cycle management, workspace switching, and native git integration.
Linear Raycast extension
Great if you already live in Raycast. macOS-only and requires leaving your terminal focus to trigger.
Linear mobile app
Different use case entirely. Built for away-from-desk triage, not for terminal-integrated daily workflow.
Common Questions
Is Linear CLI free?
Yes. Linear CLI is completely free and open source. You just need a Linear account to authenticate.
Which operating systems are supported?
Linear CLI works on macOS, Windows, and Linux. Anywhere Node.js runs, Linear CLI runs.
Does it support team workspaces?
Yes. You can switch between multiple Linear workspaces and teams directly from the CLI.
Other Projects
Switchboard
Manage unlimited accounts across 25+ services in one beautiful desktop application.
Contra Swarm
Orchestrate multiple AI agents to accomplish complex tasks with swarm intelligence.
Shopify Monitor
Command-line tool for monitoring Shopify stores. Track inventory, price changes, and product availability.
Try
Linear CLI
Check it out on GitHub, open an issue, or contribute to the project.