2.2.0 - 2026-07-22

Release Notes

Fixed

• issue query --search no longer silently drops the --cycle filter
• team members --all now actually includes disabled members (the flag was previously a no-op)
• Error suggestions now point at the real linear config command instead of the nonexistent linear configure

Added

• Cycle information in issue lists and issue view: a compact CYC column (for teams with cycles enabled) and cycle flags in --json output
• Relative cycle references (now, next, previous, signed offsets like +1) accepted by --cycle on issue query/mine/create/update and cycle view, plus issue update --clear-cycle to remove an issue from its cycle
• linear user list (alias u) to list all workspace members, team members --json output, and admin/owner/you role markers in member listings
• issue update --unassign to clear an issue's assignee
• document update --project to change which project a document is attached to
• linear team states command to list a team's workflow states; a wrong --state on issue create/issue update now errors with the list of valid states
• configure as an alias for the config command

Install linear 2.2.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/schpet/linear-cli/releases/download/v2.2.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.2.0

Download linear 2.2.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

2.1.1 - 2026-07-15

Release Notes

Fixed

• stop treating linux keyring failures as a missing password, and preserve secrets verbatim instead of trimming secret-tool output (#244; thanks @mezuzza)

Install linear 2.1.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/schpet/linear-cli/releases/download/v2.1.1/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.1.1

Download linear 2.1.1

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

2.1.0 - 2026-07-14

Release Notes

Security

• default attachment uploads to private, and add --public to issue attach and issue comment add to opt into a public url for raster images (#234; thanks @tjmgregory)

Fixed

• accept a uuid, slug id, or name for --project and --milestone across issue, milestone, and document commands (#229; thanks @jrschumacher)
• surface truncation in milestone view instead of silently capping the issue list, and add --all to paginate (#228; thanks @jrschumacher)
• allow issue create --project to stay interactive instead of failing with "title is required when not using interactive mode" (#208; thanks @mbuvarp)

Added

• add labels to issue view --json output (#170; thanks @RengarLee)
• add --content and --content-file to project create for project overview markdown, plus priority, label, member, icon, and color fields (#216; thanks @CodeWithBryan)
• add --label to project update to set a project's labels (#226; thanks @KinomotoMio)
• add --description-file to project create and update, and reject descriptions over the 255-character api limit client-side (#227; thanks @jrschumacher)
• add optional project selection to interactive issue create, gated behind the issue_create_ask_project config option (#208; thanks @mbuvarp)
• add issue_create_assign_self config option to control default self-assignment on issue create (#208; thanks @mbuvarp)
• add document comments to document view --json output (#235; thanks @josephyooo)
• show a blocked indicator in issue mine and issue query output, and surface inverseRelations in --json
• download inline images in document view so terminal renderers see local paths, and add --no-download to skip it

Changed

• issue view now orders comment threads chronologically (oldest first), matching Linear's UI
• guard document update against replacing content when active inline comments exist, since the replacement orphans their anchors; pass --force to override (#235; thanks @josephyooo)

Install linear 2.1.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/schpet/linear-cli/releases/download/v2.1.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.1.0

Download linear 2.1.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

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

1.11.1 - 2026-03-06

Release Notes

Added

• publish to npm as @schpet/linear-cli, enabling installation via npm/bun as a dev dependency

Install linear 1.11.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/schpet/linear-cli/releases/download/v1.11.1/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@1.11.1

Download linear 1.11.1

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

1.11.0 - 2026-03-05

Release Notes

Added

• project update and delete commands, plus --json flag for project commands (#148; thanks @chronosis)
• cycle list and view commands, plus --cycle filter for issue list (#162; thanks @regaw-leinad)
• issue comment delete command (#161; thanks @jholm117)
• cycle support for issue create and update commands (#150; thanks @jholm117)
• milestone support for issue create and update commands (#149; thanks @jholm117)

Fixed

• project update date validation now works correctly when combined with other flags
• issue view no longer sends auth headers to non-Linear image domains (#154; thanks @hmnd)
• project lookup now falls back to slug ID when name match fails (#158; thanks @mipearson)
• success message order corrected for 'blocked-by' issue relations
• git command errors now report more helpful messages

Install linear 1.11.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via Homebrew

brew install schpet/tap/linear

Download linear 1.11.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

1.10.0 - 2026-02-17

Release Notes

Fixed

• issue start command no longer creates extra commit after describing
• spinners now properly disabled in non-TTY environments
• correct API key creation URL in auth login (#146; thanks @srgfrancisco)

Changed

• increased sub-issues display limit from 50 to 250 in issue view (#124; thanks @paymog)
• attachment view now shows sourceType (e.g., Slack, GitHub) (#111; thanks @paymog)

Added

• raw GraphQL API access via new api subcommand (#121; thanks @bendrucker)
• issue relation command for managing dependencies between issues (#115; thanks @ztrayner)
• --sort-order flag to milestone update command (#120; thanks @bendrucker)
• user-friendly error handling with LINEAR_DEBUG environment variable for troubleshooting

Install linear 1.10.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via Homebrew

brew install schpet/tap/linear

Download linear 1.10.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

1.9.1 - 2026-01-29

Release Notes

Fixed

• switched to --allow-all for Deno permissions since --allow-run was already unrestricted (making granular permissions ineffective) and the permission flags frequently caused issues when downloading images from arbitrary domains in Linear comments

Install linear 1.9.1

Install prebuilt binaries via shell script

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

Install prebuilt binaries via Homebrew

brew install schpet/tap/linear

Download linear 1.9.1

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

1.9.0 - 2026-01-29

Release Notes

Fixed

• Fix --assignee self to correctly resolve to current user (#104; thanks @JustTrott)
• add pagination to project list command (#109; thanks @andrew-kline)
• add pagination to team list command (#107; thanks @andrew-kline)
• error when --workspace flag specifies unknown workspace
• --sort flag now works correctly after interactive prompts (#96; thanks @paymog)

Added

• built-in credential storage at ~/.config/linear/credentials.toml for managing multiple Linear workspaces
• linear auth login to add workspace credentials (auto-detects workspace from API key)
• linear auth logout to remove workspace credentials
• linear auth list to show configured workspaces with org/user info
• linear auth default to set the default workspace
• global -w, --workspace flag to target a specific workspace by slug
• --project filter for issue list command (#94; thanks @paymog)

Install linear 1.9.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via Homebrew

brew install schpet/tap/linear

Download linear 1.9.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

1.8.1 - 2026-01-23

Release Notes

Fixed

• sync deno permissions to compiled binaries ensuring uploads, public downloads, and config paths work correctly

Install linear 1.8.1

Install prebuilt binaries via shell script

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

Install prebuilt binaries via Homebrew

brew install schpet/tap/linear

Download linear 1.8.1

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