Skip to main content
command

release · davila7 — Claude Code command: what it does, how to install

Prepares project releases by parsing git history, bumping version files, updating CHANGELOG.md, and tagging git commits.

Install into Claude Code · claude-code-templates All methods and platforms ↓
npx claude-code-templates@latest --command project-management/release
Open on GitHub

What release does

The release slash command automates project versioning. It inspects local repository status through git status and reviews recent commits. After locating the previous git tag, it evaluates changes against semantic versioning conventions.

The command targets version files like package.json, setup.py, or Cargo.toml. It sorts changelog entries in CHANGELOG.md under sections like Added, Changed, and Fixed. When new features require documentation updates, it inspects README.md. A git release tag completes the run.

Execution relies on Read, Write, Edit, and Bash tools. Without an initialized git repository, tag inspection fails immediately. You can specify version increments manually using flags instead of automated inference.

What it helps with

  • determine semver bump from recent git commits
  • update version tags in package.json, setup.py, or Cargo.toml
  • organize changelog entries into categorized sections
  • tag the release commit in git

Example prompts for the agent

  • /release
  • /release --minor
  • /release --patch

How to install release

1claude-code-templates

npx claude-code-templates@latest --command project-management/release

2Manually: put the files in place

.claude/commands/release.md

Call it with /release. For all projects use ~/.claude/commands/

Questions about release

How do I install release in Claude Code?

Run npx claude-code-templates@latest --command project-management/release in your terminal. This creates .claude/commands/release.md.

What does the release command do?

It reviews git history since the last release, determines semantic version increments, updates manifest files, writes release notes to CHANGELOG.md, and creates a tag.

Which version flags can I pass to release?

You can provide --patch, --minor, --major, or --prerelease. Omission lets the agent analyze commits and suggest the version increment.

Source text

release.md · MIT
---
allowed-tools: Read, Write, Edit, Bash
argument-hint: "[version-type] | --patch | --minor | --major | --prerelease"
description: Prepare and execute project release with version management and changelog updates
---

# Project Release

Update CHANGELOG.md with changes since the last version increase. Check our README.md for any necessary changes. Check the scope of changes since the last release and increase our version number as appropriate: **$ARGUMENTS**

## Current Project State

- Git status: !`git status --porcelain`
- Current version: !`git describe --tags --abbrev=0 2>/dev/null || echo "No previous tags"`
- Recent commits: !`git log --oneline --since="1 month ago" | head -10`
- Package info: @package.json or @setup.py or @Cargo.toml (if exists)

## Task

Prepare a project release following these steps:

1. **Analyze Changes**: Review git history since last release to determine appropriate version increment
2. **Update Version**: Update version in package.json, setup.py, or other version files based on semantic versioning
3. **Update Changelog**: Add new entries to CHANGELOG.md with proper categorization (Added, Changed, Fixed, etc.)
4. **Update Documentation**: Review and update README.md if necessary for new features or changes
5. **Create Release**: Tag the release and prepare release notes

If version type is specified in $ARGUMENTS, use that increment. Otherwise, analyze the changes and suggest appropriate versioning.

Focus on maintaining proper semantic versioning and clear changelog documentation.

© davila7 · MIT · davila7/claude-code-templates

Similar slash commands

All slash commands for Git and GitHub →

release by other authors comes first.

From the same set804

The whole set →

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor