v2026.4.6

Full Changelog: v2026.4.5...v2026.4.6

Fixed

• enforce strict team-scale estimate validation for issues create --estimate and issues update --estimate, including hard fail when team estimates are disabled (notUsed)

v2026.4.5

Full Changelog: v2026.4.4...v2026.4.5

Added

• Initiatives domain support — new initiatives command group with typed GraphQL operations, service layer CRUD/relation/project-link flows, resolver ID translation, and CLI usage metadata wiring
• Issue attachments management — new attachments command group (list, create, delete) and issues read --with-attachments for embedded issue attachment expansion #55
• Reusable numeric option parsing — shared integer parsers for issue CLI flags to standardize validation and option handling
• Retry backoff for transient API failures — exponential retry delays for retryable HTTP/GraphQL failures

Fixed

• Initiatives GraphQL operations now align with current schema shape and pagination behavior for relation/link lookups
• Initiative command surface corrected for sorting and update/create signatures to match implementation constraints
• Issue create/update now validate --priority and --estimate values early before resolver/service calls
• Retry middleware now wraps only raw HTTP transport so retry classification inspects original status codes
• Auth error handling now discriminates empty catch paths explicitly for safer failure reporting

CI & Build

• Added CI guard preventing accidental docs/plans/*.md history in PR branches
• Updated runtime dependency @linear/sdk to v81 and refreshed non-major dev dependencies

Testing

• Expanded issue numeric validation test coverage and retry backoff timer coverage
• Added failing/coverage tests for multi-relation and initiative service/update flows

v2026.4.4

Full Changelog: v2026.4.3...v2026.4.4

Changed

• Restored the dedicated issues search <query> subcommand while keeping issues list --query <query> as a deprecated compatibility path for one release window; both commands now share the same filter flags #121, PR#124

CI & Build

• Switched the publish workflow from npm install to npm ci for reproducible clean installs in CI PR#122

v2026.4.3

Full Changelog: v2026.4.2...v2026.4.3

Added

• Estimate support — --estimate on issues create, and --estimate/--clear-estimate on issues update with scale-neutral descriptions and --estimate 0 support PR#94

Fixed

• Replaced postinstall with prepare to fix broken consumer installs via npm install -g linearis #120, PR#123

CI & Build

• Added clean-publish to strip dev artifacts from published tarball PR#123
• Added smoke test for consumer package install PR#123

Documentation

• Updated contributing guide with publishing section and lifecycle hook policy PR#123

v2026.4.2

Full Changelog: v2026.4.1...v2026.4.2

Added

• Due date support — --due-date option on issues create, and --due-date/--clear-due-date on issues update PR#119
• Project CRUD commands — new project read, project create, and project update commands with label and status ID resolution PR#118
• Comment management — new comments list, comments reply, comments edit, and comments delete subcommands PR#81
• XDG_CONFIG_HOME support — token storage now respects XDG_CONFIG_HOME on Linux #73
• GitHub release automation — publish workflow now creates GitHub releases automatically PR#77

Fixed

• Migrated moduleResolution from Node to Bundler for TypeScript 6 compatibility PR#107
• Added prepack script for git-based installs PR#80
• Updated @linear/sdk to v80 PR#109
• Updated commander to v14.0.3 PR#103

Changed

• Standardized delete return types to {id, success} across all delete operations PR#86

CI & Build

• Expanded CI matrix to test Node.js 22 and 24 PR#112
• Pinned publish workflow to minimum supported Node version PR#113
• Aligned action versions to v6 across CI and publish workflows PR#92
• Added content permission to CI workflow PR#99
• Added CODEOWNERS file for security review gates

Maintenance

• Updated TypeScript to v6, Vitest to v4, @types/node to v24
• Updated dev dependencies (non-major)
• Disabled Renovate dependency dashboard
• Updated .gitignore to exclude generated files
• Removed obsolete mise config and tasks

Documentation

• Replaced manual contributor list with contrib.rocks PR#102

v2026.4.1

Full Changelog: v2025.12.3...v2026.4.1

Breaking Changes

• Complete architecture rewrite to a strict five-layer architecture: CLI Input → Command → Resolver → Service → JSON Output. #45, #27, #43, #47, PR#49
• embeds commands renamed to files — embeds download → files download, embeds upload → files upload
• project-milestones commands renamed to milestones
• search subcommands merged into list — use issues list --status ... instead of issues search --status ...

Added

• Encrypted token authentication — linearis auth login opens Linear in the browser and stores the token encrypted in ~/.linearis/token. New subcommands: auth login, auth status, auth logout
• Issue relation flags — --blocks, --blocked-by, --relates-to on issue update
• Cursor pagination — --after and --limit flags on all list commands
• Assignee resolution — --assignee flag resolves by name or email
• usage subcommand on every command group for self-documenting CLI help
• Request timeouts — GraphQL API requests time out after 30 seconds, file download/upload after 60 seconds. Prevents indefinite hangs, especially important for LLM agent tool timeouts
• GraphQL Code Generator pipeline — queries and mutations defined in .graphql files under graphql/, codegen produces typed DocumentNodes
• Biome for formatting and linting (replaces previous setup)
• Lefthook git hooks with commitlint for conventional commit enforcement
• Security policy (SECURITY.md) with responsible disclosure process
• GitHub community templates — bug report form, feature request form, PR template

Fixed

• File download and upload commands now use proper error exit codes (exit 1) on failure instead of returning exit code 0 with a success envelope

Documentation

• Complete documentation rewrite for v2 architecture
• New docs: architecture.md, development.md, testing.md, build-system.md with layer invariants, mock patterns, and service/resolver/command templates
• AGENTS.md restructured for machine-first readability with decision trees and anti-patterns
• README.md rewritten for current CLI commands and agent optimization
• CONTRIBUTING.md expanded with dev setup, testing, and architecture pointer
• Removed obsolete 26k-line GraphQL schema dump and completed implementation plans

v2025.12.3

Full Changelog: v2025.12.2...v2025.12.3

Mini hotfix for v2025.12.2 🤷🏻‍♂️

Fixed

• Version string now read from package.json instead of being hardcoded

v2025.12.2

Full Changelog: v2025.11.3...v2025.12.2

Added

• New embeds upload command to upload files to Linear storage – thanks, @chadrwalters! PR#23
• New documents commands for Linear document management – thanks, @ralfschimmel! PR#21
• issues commands now include the branchName field (the git branch name associated with the issue). #14
• Diagnostic output for issue transform errors, showing raw API response and stack trace to help debug null field issues. #6

Breaking Changes

• Issue "status" flag renamed: --state/--states options renamed to --status for consistency with Linear's UI terminology. Thanks for the (appreciated but ultimately unused) PR, @ralfschimmel!
  • issues search --states → --status (still accepts comma-separated values)
  • issues update --state → --status (short flag -s unchanged)

Tooling

• Prepublish validation to ensure dist/main.js exists and is executable before publishing to npm
• Cleaned up the tiny pnpm vs npm mess, it's now npm all the things

2025.11.3

Full Changelog: 2025.11.2...v2025.11.3

Added

• New teams command with list subcommand 🎉 – thanks, Chad! PR#13
  • Lists all teams in workspace with id, key, name, and description
  • Results sorted alphabetically by name
• New users command with list subcommand PR#13
  • Lists all users with id, name, displayName, email, and active status
  • Supports --active flag to filter for active users only
  • Results sorted alphabetically by name
• Integration tests for teams and users commands PR#13

Fixed

• GraphQL orderBy error resolved by implementing client-side sorting for teams and users list commands PR#13
• Project name matching is now case-insensitive (using eqIgnoreCase) for better UX PR#13

Documentation

• Added "Teams & Users" section to README.md with usage examples
• Updated docs/architecture.md, docs/development.md, and docs/files.md to reference new commands

2025.11.2

Full Changelog: 2025.11.1...2025.11.2

Now also available @ https://www.npmjs.com/package/linearis, like a big boi.

Added

• New cycles and project-milestones commands 🎉 – thanks, Ryan! PR#7
• The issues commands now include parent and child issue relationships
  • parentIssue field with { id, identifier, title } for parent issue (if exists)
  • subIssues array with { id, identifier, title } for immediate child issues
  • Available in all issue commands: read, list, and search

Fixed

• issues commands' embed parser now correctly ignores markdown URLs inside code blocks and inline code
  • Previously extracted URLs from code examples and documentation
  • Ensures only actual embedded files are detected, not code examples
• All date/time fields now output in ISO 8601 format (2025-11-09T23:00:00.000Z) instead of verbose JavaScript date strings
• Under-the-hood stability bug fixes.