Skip to main content
command CX Codex

run-release — Claude Code command: orchestrate releases

run-release — a Claude Code command that triggers a release workflow using semantic version tags. It automates creation of annotated tags, draft releases, and requires approval before publishing.

MIT ★ 907 updated 2025-11-12

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/run-release.md
Open on GitHub

What run-release does

Call the command with a required version parameter in vX.Y.Z format and an optional target branch (defaults to main). Before running, complete the Release Checklist and verify that /review and /security-scan pass on the target branch.

When invoked, the command runs the GitHub workflow release-orchestrator.yml with the specified version and target branch. The workflow pauses at the environment approval step for the release environment—you must approve it to publish the annotated tag and draft release.

Once approved, the workflow completes and the draft release appears on GitHub. The final step is to review and publish the draft manually.

What it helps with

  • trigger a release workflow with the correct version and target branch
  • create an annotated tag and draft release on GitHub
  • enforce review and security scan checks before release
  • require manual approval before publishing a release

Example prompts for the agent

  • Run release version v1.2.3 on main: /run-release v1.2.3
  • Run release version v2.0.0 on release/2.0 branch: /run-release v2.0.0 release/2.0
  • Create a draft release v1.0.0 with approval gate: /run-release v1.0.0

How to install run-release

Manually: put the files in place

.claude/commands/run-release.md

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

Questions about run-release

How do I install run-release in Claude Code?

Create a .claude/commands/run-release.md file in your project root with the command definition. After that, the command becomes available in Claude Code.

What does run-release do?

The command triggers a GitHub workflow to orchestrate a release using semantic version tags. It creates an annotated tag, draft release, and requires approval before publishing.

What checks must pass before I run it?

Complete the Release Checklist issue and ensure /review and /security-scan are green on the target branch.

Source text

run-release.md · MIT
---
description: Orchestrate a tagged release using the release workflow.
argument-hint: <version> [target]
---

## Pre-flight
- Complete the Release Checklist issue.
- Ensure `/review` and `/security-scan` are green on the target branch.

## Trigger Workflow
```
/run-release vX.Y.Z [target]
```

- `vX.Y.Z`: Required semantic version tag (include the `v`).
- `target`: Optional branch/commit (defaults to `main`).

### Command
```bash
gh workflow run release-orchestrator.yml \
  --ref ${target:-main} \
  -f version=${version} \
  -f target=${target:-main}
```

## After Triggering
1. Wait for the `Release Orchestrator` workflow to reach the environment approval step.
2. Approve the `release` environment to publish the annotated tag and draft release.
3. Review and publish the draft release on GitHub.

© alirezarezvani · MIT · alirezarezvani/claude-code-skill-factory

Similar slash commands

All slash commands for DevOps and infrastructure →

From the same set36

The whole set →

Project sponsors

Companies that keep this analytics open