goosewobbler/ReleaseKit – Automated Versioning & Release
Run ReleaseKit in preview or release mode
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jul 4, 2026
- License
- MIT
Pinned Snippet
uses: goosewobbler/releasekit@ffd4949c96833893e8f375a3bbd407ec75a67642 # v0.39.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| mode | Action mode (release, preview, gate, standing-pr-update, standing-pr-publish, backfill, or refresh-after-release) | no | preview |
| config | Path to releasekit config file | no | — |
| project-dir | Project directory to run in | no | . |
| dry-run | Dry-run mode | no | false |
| json | Enable JSON output (release mode) | no | false |
| verbose | Enable verbose logging | no | false |
| quiet | Suppress non-error output | no | false |
| skip-checkout | Skip repository checkout (assume repo is already checked out). WARNING: Ensure repository has full git history (fetch-depth: 0) for proper version-bumping logic. Shallow clones may cause incorrect version bumps or silent failures. | no | false |
| bump | Force bump type (patch|minor|major|prerelease) | no | — |
| prerelease | Create prerelease version (optional identifier) | no | — |
| stable | Graduate prerelease packages to stable without bumping | no | false |
| sync | Use synchronized versioning | no | false |
| target | Target packages (comma-separated) | no | — |
| scope | Scope name to resolve to target packages from ci.scopeLabels config | no | — |
| branch | Override git branch used for push | no | — |
| node-version | Node.js version | no | 20 |
| npm-auth | NPM auth method (auto|oidc|token) | no | auto |
| npm-token | NPM token for publishing (or use NPM_TOKEN input) | no | — |
| skip-notes | Skip changelog generation | no | false |
| skip-publish | Skip registry publishing and git operations | no | false |
| skip-git | Skip git commit/tag/push | no | false |
| skip-github-release | Skip GitHub release creation | no | false |
| skip-verification | Skip post-publish verification | no | false |
| ssh-key | SSH deploy key for git push (enables SSH checkout when not dry-run) | no | — |
| reconcile | Bypass the skip-pattern guard in standing-pr-update mode (for post-release reconcile runs, where HEAD is a release commit) | no | false |
| pr | Pull request number (preview mode; standing-pr-publish mode when not triggered by a pull_request event) | no | — |
| repo | Repository in owner/repo format (preview mode) | no | — |
| preview-prerelease | Force prerelease preview (optional identifier) | no | — |
| preview-stable | Force stable preview | no | false |
| preview-dry-run | Print preview markdown without posting | no | false |
| preview-target | Target packages in preview mode (comma-separated) | no | — |
| summary | Write GITHUB_STEP_SUMMARY markdown | no | true |
| package | Package to backfill (backfill mode; defaults to the package.json name at `path`) | no | — |
| path | Package directory to backfill (backfill mode) | no | — |
| all | Backfill every package in the workspace (backfill mode) | no | false |
| from | Earliest version to backfill, inclusive (backfill mode) | no | — |
| to | Latest version to backfill, inclusive (backfill mode) | no | — |
| update-releases | Update matching GitHub release bodies via `gh release edit` (backfill mode) | no | false |
| only-missing | With update-releases, skip releases already carrying releasekit notes (backfill mode) | no | false |
| apply | Apply changes instead of a dry-run preview (backfill mode) | no | false |
Outputs
| name | description |
|---|---|
| success | Whether action completed successfully |
| mode | Executed mode |
| standing-pr-action | Standing PR action taken (created, updated, closed, or noop) |
| standing-pr-number | Standing PR number |
| standing-pr-url | Standing PR URL |
| should-release | Whether a release should proceed (gate mode) |
| bump | Resolved bump type (gate mode) |
| gate-scope | Resolved scope name (gate mode) |
| gate-target | Resolved target packages (gate mode) |
| gate-stable | Whether the release should be a stable graduation (gate mode, release:graduate label) |
| has-changes | Whether a release has changes (release mode, requires json: true) |
| version-output | Version output JSON (release mode) |
| tags | Comma-separated tags (release mode) |
| release-output | Full release output JSON (release mode) |
| preview-markdown | Preview markdown (preview mode with dry-run) |
| preview-posted | Whether preview was posted (preview mode, non-dry-run) |