# Release

Cut an OpenWork release, release the app, publish a new version, rerun or recover a...

- Repository: https://github.com/different-ai/openwork (24362 stars)
- Category: Git and review
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add different-ai/openwork --skill release -g -a claude-code -y`
Codex: `npx skills add different-ai/openwork --skill release -g -a codex -y`
Cursor: `npx skills add different-ai/openwork --skill release -g -a cursor -y`
Gemini CLI: `npx skills add different-ai/openwork --skill release -g -a gemini-cli -y`

## Description

Cut an OpenWork release, release the app, publish a new version, rerun or recover a release tag, verify release assets. Tag-driven GitHub Actions release that makes zero commits to the repo.

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

# Skill: release

Cut an OpenWork release. The "Release App" workflow
(`.github/workflows/release-macos-aarch64.yml`) builds, signs, and publishes
the desktop app assets on the GitHub release. Full runbook:
`docs/RELEASING.md`.

**Versions live in git tags only.** Every committed `package.json` holds the
permanent `0.0.0-dev` placeholder; CI stamps the tag-derived version into the
workspace at build time (`scripts/release/stamp-version.mjs`). A release makes
**zero commits to this repo**, no bump commit, no backfill PR, no packaging
PR.

A release is **done when the run is green and the GitHub release is published**
(not a draft), never when the tag is created.

---

## Before you tag: open fix PRs and fork PRs

Run this before `release:cut` or any manual tag. It exists because a fork PR
carrying the exact fix for a blank-window-on-launch regression sat open for a
day before the affected version was tagged (incident 2026-09-09): fork PRs
never receive Warden clearance (`warden.yml` skips them and
`warden-clearance.yml` requires `head_repository == repository`), so nothing
surfaces them until a human looks.

List, against `dev`, every open PR opened since the previous stable tag whose
title or body matches `fix(app)|crash|blank|white screen|regression|first
launch`, plus every open fork PR created or updated in that window:

The rest: https://github.com/different-ai/openwork/blob/HEAD/.opencode/skills/release/SKILL.md