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

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

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

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.

Full Changelog: 1.1.0...2025.11.1

Added

• issues commands' results now include embeds array containing tickets' file embeds
  • Embed extraction from issue descriptions and comments
    • Parses markdown for Linear upload URLs (![label](url) and [label](url))
    • Returns embeds array in issues read command output
    • Each embed includes label, url, and expiresAt (ISO 8601 timestamp)
• New embeds command group for downloading embedded files from Linear's cloud storage
  • embeds download <url> command to download files
    • --output <path> option for custom output location
    • --overwrite flag to replace existing files
    • Automatic directory creation for output paths

Documentation

• Renamed CLAUDE.md to AGENTS.md, re-added CLAUDE.md as a symlink
• Updated AGENTS.md with file download features and signed URL documentation
• Added File Downloads section to README.md with usage examples
• Updated docs/files.md with new command and utility files
• Added embeds command flow and extraction flow diagrams to documentation