Full Linear API access from the terminal — search, create and update issues, manage projects, cycles, roadmaps, webhooks, notifications, documents, and more. Every command outputs JSON.
Every command outputs structured JSON — pipe into jq, scripts, or AI agents
80+ commands covering issues, projects, cycles, roadmaps, teams, documents, webhooks, notifications, and more
Search across issues, documents, and projects. Results include identifiers, titles, and metadata — ready for scripting.
Create, update, delete, archive, and fetch issues by ID or identifier. Filter by team, assignee, state, priority, or label.
Full CRUD for projects, cycles, roadmaps, and initiatives. List milestones, post project updates, and manage planning entities.
Add, edit, delete, resolve, and unresolve comments. List your own comments. Full comment lifecycle from the terminal.
Link GitHub PRs, issues, and external URLs to Linear issues. Create and delete issue relations (blocks, duplicate, related).
List, create, update, and delete labels. List workflow states per team. Complete metadata management from the CLI.
List notifications, mark individual ones read or unread, and bulk-archive or bulk-mark all notifications in one command.
List, create, update, and delete webhooks. Full webhook lifecycle management without leaving the terminal.
List all teams, fetch a single team, list all users or look up a specific user. Essential for scripting assignments.
Check Linear platform status including ongoing incidents and scheduled maintenances. No API key required.
Interactive setup validates your API key against the Linear API before storing it. Reconfigure anytime with --force.
Includes a Warp and Claude Code skill. Agents automatically use linear when you ask about bugs or issues.
All list commands fetch every page automatically. No manual cursor handling — just get all the data.
Three steps from install to your first Linear query
Install @dotbrains/linear-cli from GitHub Packages. One-time registry and auth token setup, then a single npm install.
Run `linear init` to interactively set up your Linear API key. It validates the key against the API before saving.
Search issues, manage projects, post comments, track notifications, manage webhooks — all from the command line. Pipe JSON into jq, scripts, or AI agents.
See linear-cli in action — search, issues, comments, and agent workflows
# Full-text search across issues, documents, and projects
$ linear search "auth bug"
→ [
{ "identifier": "ENG-123", "title": "Fix auth race condition", ... },
{ "identifier": "ENG-456", "title": "Auth token expiry bug", ... },
{ "identifier": "ENG-789", "title": "OAuth callback failure", ... }
]
# Search for documents
$ linear search "onboarding" --type DocumentsFrom agent automation to CI pipelines — linear fits into any workflow
Let Warp or Claude autonomously search, triage, update, and comment on issues. The included skill gives agents full Linear API access.
Search for issues by keyword, filter by label, and quickly assess priorities — all without leaving your terminal.
Script bulk comment additions across issues. Pipe issue identifiers into comment-add for automated triage notes.
Check Linear platform status from CI pipelines or monitoring scripts. Detect incidents before they affect your workflow.
All output is JSON — pipe into jq for transforms, feed into dashboards, or generate reports from issue and comment data.
Search for related issues in CI, post deployment comments automatically, or gate releases on issue status.
Install and run your first Linear query in under a minute
Note: Published to GitHub Packages. One-time registry + auth setup required.
# 1. Point @dotbrains scope at GitHub Packages
npm config set @dotbrains:registry https://npm.pkg.github.com
# 2. Authenticate (use a PAT with read:packages scope)
npm config set //npm.pkg.github.com/:_authToken $(gh auth token)
# 3. Install globally
npm install -g @dotbrains/linear-cli# Set up your Linear API key
linear init
# Search for issues
linear search "auth bug"
# Get a specific issue with comments
linear issue ENG-123
# Create an issue
linear issue-create --team <teamId> --title "Fix login bug" --priority 1
# Add a comment
linear comment-add ENG-123 -b "On it"
# List your notifications
linear notifications
# Check Linear platform status
linear statusTip: Generate a personal API key at Linear > Settings > Security.
Install @dotbrains/linear-cli and manage Linear from the command line in under a minute