---
name: Bump Version
slug: bump-version-5
category: DevOps
description: Bump Version updates package.json, .claude-plugin/plugin.json, and .sd0x/install-state.json to the same version. Use it when you need to increment or set a plugin version in sync across files.
github: "https://github.com/sd0xdev/sd0x-harness/tree/main/skills/bump-version"
language: JavaScript
stars: 188
forks: 24
install: "npx degit https://github.com/sd0xdev/sd0x-harness/tree/main/skills/bump-version ~/.claude/skills/bump-version"
installs_to: ~/.claude/skills/bump-version
source_path: skills/bump-version/SKILL.md
collection_size: 25
category_size: 1013
collection_url: "https://dirskills.com/collections/sd0xdev/sd0x-harness"
added: 2026-09-06T05:20:11.651Z
last_synced: 2026-09-06T05:20:11.651Z
canonical_url: "https://dirskills.com/skills/bump-version-5"
---

# Bump Version

Bump Version updates package.json, .claude-plugin/plugin.json, and .sd0x/install-state.json to the same version. Use it when you need to increment or set a plugin version in sync across files.

**Install:**

```bash
npx degit https://github.com/sd0xdev/sd0x-harness/tree/main/skills/bump-version ~/.claude/skills/bump-version
```

## README

# Bump Version

Update `package.json`, `.claude-plugin/plugin.json`, and `.sd0x/install-state.json` versions in sync.

## Workflow

1. Read current versions from all files
2. Determine new version (from argument or auto-increment)
3. Update all files to the same version
4. Report result

## Step 1: Read Current Versions

```bash
grep '"version"' package.json .claude-plugin/plugin.json
```

Also check manifest:

```bash
grep '"plugin_version"' .sd0x/install-state.json 2>/dev/null || echo "(no manifest)"
```

If versions are already out of sync, warn user before proceeding.

## Step 2: Determine New Version

| Input | Action |
|-------|--------|
| Explicit version (e.g., `1.9.0`) | Use as-is |
| `major` | Bump major: `1.8.1` → `2.0.0` |
| `minor` | Bump minor: `1.8.1` → `1.9.0` |
| `patch` (default) | Bump patch: `1.8.1` → `1.8.2` |
| No argument | Default to `patch` |

## Step 3: Update All Files

Use Edit tool to update version fields:

1. `package.json` — `"version"` field
2. `.claude-plugin/plugin.json` — `"version"` field
3. `.sd0x/install-state.json` — `"plugin_version"` field (if file exists)

All must be set to the **exact same version string**.

The manifest update prevents the SessionStart drift sentinel from firing false warnings after every version bump in the plugin source repo.

## Step 4: Report

```
## Version Bump

| File | Field | Before | After |
|------|-------|--------|-------|
| package.json | version | x.y.z | a.b.c |
| .claude-plugin/plugin.json | version | x.y.z | a.b.c |
| .sd0x/install-state.json | plugin_version | x.y.z | a.b.c |
```

## Prohibited

- Never set different versions across the files
- Never modify other fields in the JSON files