2.0.0 - 2026-04-03

Release Notes

please note this is a major release in the semver sense of it being a breaking one:

json output shapes changed

my apologies to anyone who might be scripting this thing - i'd probably say api is more stable for that if that's you

issue list is being broken into issue mine and issue query

this project came about as a nicer way for me to find and 'start' issues from a repo, but with the whole LLM thing it gets used differently. so i'm hoping this supports that better. we will see!

and lastly @bendrucker made a nice change to improve security of your keys via keyring support. i'll note neither of us had machines to test it on windows and headed linux, so if it's broken, PRs are extremely welcome!

for anyone using this with agents, i encourage you to add or update the skill.

# claude code
claude plugin marketplace update linear-cli
claude plugin update linear-cli@linear-cli

# other
 npx skills update schpet/linear-cli

Fixed

• alphanumeric team keys (e.g. team keys with numbers) now accepted
• workspace flag collision: removed -w short alias from --workspace to avoid conflict with --web
• auth migrate keyring error message now includes suggestion

Changed

• json output now preserves GraphQL field names and connection shape across all commands
• issue view resolved thread metadata format

Added

• issue list split into issue mine and issue query. mine is your personal work queue (unstarted issues assigned to you). query handles cross-team filtering, --json output, and full-text search via --search. issue list is aliased to mine for now but should be considered deprecated
• agent-session list and view commands (#192; thanks @paymog)
• issue link command to attach URLs to issues (#185; thanks @lucleray)
• keyring storage for API keys on macOS, Linux, and Windows (#136; thanks @bendrucker)
• label filter (--label) for issue list and issue query (#180; thanks @mihai-chiorean)
• project label filter (--project-label) to match issues across all projects with a given label (#178; thanks @AlJohri)
• date filters (--created-after, --updated-after) for issue list and issue query (#191; thanks @jholm117)
• json output (--json) for issue list, issue create, and cycle list (#179; thanks @mihai-chiorean)
• assignee, priority, and state display in issue view (#190; thanks @jholm117)
• issue documents shown in issue view

Install linear 2.0.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/schpet/linear-cli/releases/download/v2.0.0/linear-installer.sh | sh

Install prebuilt binaries via Homebrew

brew install schpet/tap/linear

Install prebuilt binaries into your npm project

npm install @schpet/linear-cli@2.0.0

Download linear 2.0.0

File	Platform	Checksum
linear-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
linear-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
linear-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
linear-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
linear-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum