| name | bump-the-version |
| description | Repo-local release workflow for this Ailtir plugin repository. Use when the user asks to bump the plugin version, update plugin/.claude-plugin/plugin.json, update CHANGELOG.md, create the version bump commit, and tag that version commit. |
Bump The Version
Workflow
Use scripts/bump_version.py from this skill. Run it from the repository root.
python3 .codex/skills/bump-the-version/scripts/bump_version.py 2.10.2 \
--note "Fixed telemetry reporting when Claude invokes plugin helper scripts by absolute path."
The script performs the repo-specific release sequence:
- Require a clean worktree before changing files.
- Update
plugin/.claude-plugin/plugin.json.
- Insert a newest-first section in
CHANGELOG.md.
- Commit the manifest and changelog with
Bump version to X.Y.Z.
- Tag that version-bump commit as
vX.Y.Z.
- Replace the changelog
pending marker with the version commit hash.
- Commit the changelog reference as
Update changelog version reference.
The tag must point to the version bump commit, not the changelog-reference
follow-up commit.
Release Notes
Pass one or more --note values when the release has specific user-visible
changes:
python3 .codex/skills/bump-the-version/scripts/bump_version.py 2.10.2 \
--note "Fixed telemetry reporting for installed plugin helpers." \
--note "Kept plugin runtime variables out of user-facing configuration."
If the user only asks for a version bump and gives no release-note text, let the
script use its default note. Do not invent detailed release notes without
inspecting the commits since the previous version.
Pushing
The script creates local commits and a local tag by default. If the user asks to
push too, run:
git push
git push origin vX.Y.Z
Do not use git push --tags unless the user explicitly asks to push every local
tag.
