Upgrading
Breaking changes and how to migrate.
Track breaking changes here as they ship. Each entry explains what broke, why, and what to do.
1.x → (no breaking changes yet)
ReleaseJet 1.x is backward-compatible within the major version. Future breaking changes will be documented here with migration steps.
See also: CHANGELOG.
What's new
1.17.0
- Four new
releasejet authsubcommands for managing~/.releasejet/credentials.ymlfrom the CLI:auth list-tokens— list every stored token, masked by default (--show-tokensreveals).auth show-token— diagnostic that prints all six resolution steps and which one matched. Use when the wrong token is being picked up.auth remove-token— delete a host, repo, or legacy entry. Mutually-exclusive--host/--repo/--legacy.auth migrate-tokens— interactive walkthrough that copies legacygitlab:/github:entries into host-keyed entries.
- All four preserve other top-level YAML keys (notably the Pro
pro:license block). - See Managing tokens for the full reference.
1.16.0
~/.releasejet/credentials.ymlis now keyed by host (e.g.gitlab.com,company.gitlab.com) with optional<host>/<projectPath>per-repo overrides. Use a different token for each self-hosted GitLab instance or for a specific project.- New CLI subcommand:
releasejet auth set-token— with--host,--repo, or auto-detect from the current repo — writes tokens into the file via a masked prompt. - No migration required: legacy
gitlab:/github:keys and the bare-text~/.releasejet/credentialsfile continue to work as wildcard fallbacks. - See Authentication & tokens for the full 6-step token lookup.
1.14.0
- New
description: 'none' | 'extract' | 'ai'top-level config field. When set toextract, release notes render a cleaned, ~200-character excerpt of each issue/PR body under its title. Default isnone(no change in output). Theaivalue is reserved for the Pro M3a plugin and is treated asnonein core. See Issue / PR descriptions.