linear-pp-cli

Linear CLI for the terminal: local SQLite mirror, offline FTS search, cycle/issue/project analytics (bottleneck, load, blocking, orphans, initiatives health), and an MCP server (linear-pp-mcp, 28 tools).

Origin & maintenance

Originally generated by CLI Printing Press and published in mvanhorn/printing-press-library (creator: Matt Van Horn). This is the Plexiz-maintained standalone fork, carrying fixes we need shipped now rather than waiting on upstream merges:

• projects sync page size 50 -> 25 — the original ProjectsQuery nests projectMilestones(first: 50) inside projects(first: 50); Linear multiplies nested connection complexity, scoring ~12305 over its 10000 cap, so every sync failed projects with HTTP 400 "Query too complex". Page size 25 scores ~6152; pagination still fetches all. (Upstream: mvanhorn/printing-press-library#946 / PR #1013.)
• go 1.26.4 — patched standard library (GO-2026-5037 crypto/x509, GO-2026-5039 net/textproto).

Install

go install github.com/pabloglzg/linear-pp-cli/cmd/linear-pp-cli@latest
go install github.com/pabloglzg/linear-pp-cli/cmd/linear-pp-mcp@latest   # optional MCP server

Auth

linear-pp-cli auth set-token <LINEAR_API_KEY>   # or env LINEAR_API_KEY
linear-pp-cli doctor
linear-pp-cli sync

Get a key at https://linear.app/settings/api.