# Version Bump and Release

Bumps plugin versions in every manifest, tags the release and writes the changelog.

- Repository: https://github.com/thedotmack/claude-mem (109099 stars)
- Category: DevOps
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add thedotmack/claude-mem --skill version-bump -g -a claude-code -y`
Codex: `npx skills add thedotmack/claude-mem --skill version-bump -g -a codex -y`
Cursor: `npx skills add thedotmack/claude-mem --skill version-bump -g -a cursor -y`
Gemini CLI: `npx skills add thedotmack/claude-mem --skill version-bump -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add thedotmack/claude-mem`

## Description

Automated semantic versioning and release workflow for Claude Code plugins. Handles version increments across package.json, marketplace.json, plugin.json manifests, build verification, git tagging, GitHub releases, and changelog generation. npm publishing is done by the tag-triggered GitHub Actions workflow through npm trusted publishing.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Version Bump & Release Workflow

**IMPORTANT:** Plan and write detailed release notes before starting.

**CRITICAL:** Commit EVERYTHING (including build artifacts). At the end of this workflow, NOTHING should be left uncommitted or unpushed. Run `git status` at the end to verify.

## Preparation

1.  **Analyze**: Determine if the change is **PATCH** (bug fixes), **MINOR** (features), or **MAJOR** (breaking).
2.  **Environment**: Identify repository owner/name from `git remote -v`.
3.  **Paths, every file that carries the version string**:
    - `package.json`, **the npm/npx-published version** (`npx claude-mem@X.Y.Z` resolves from this)
    - `plugin/package.json`, bundled plugin runtime deps
    - `.claude-plugin/marketplace.json`, version inside `plugins[0].version`
    - `.claude-plugin/plugin.json`, top-level Claude-plugin manifest
    - `plugin/.claude-plugin/plugin.json`, bundled Claude-plugin manifest
    - `.codex-plugin/plugin.json`, Codex-plugin manifest
    - `plugin/.codex-plugin/plugin.json`, bundled Codex-plugin manifest
    - `.qoder-plugin/plugin.json`, Qoder plugin manifest
    - `plugin/.qoder-plugin/plugin.json`, bundled Qoder plugin manifest
    - `openclaw/openclaw.plugin.json`, OpenClaw plugin manifest
    - `.grok-plugin/plugin.json`, Grok plugin manifest
    - `claude-mem-cursor/.cursor-plugin/plugin.json`, Cursor plugin manifest
    - `claude-mem-grok-bot/.cursor-plugin/plugin.json`, Grok Bot Cursor plugin manifest
    - `dsh/package.json`, bundled DSH plugin package
    - `README.md`, the version badge (`version-X.Y.Z-green`), not a `"version"` key

    Verify coverage before editing: `git grep -l "\"version\": \"<OLD>\""` should list the fourteen JSON files above, and `git grep -n "version-<OLD>-green"` the README badge. If a new manifest has been added since this doc was last updated, update this list.

## Workflow

The rest: https://github.com/thedotmack/claude-mem/blob/HEAD/plugin/skills/version-bump/SKILL.md