How does it handle upstream dependencies?

It automatically extracts and records the pinned versions of zsh-kit and codex-kit from your VERSIONS.env file directly into the CHANGELOG.md release entry.

Do I need Docker installed to use this skill?

Yes, a working Docker environment is required as the skill runs real-world E2E tests to validate the workspace launcher before allowing a release.

What makes the E2E gate mandatory?

The skill is configured to abort the release process immediately if local Docker-based tests fail, ensuring no broken images are ever published to the production branch.

Can it create GitHub releases automatically?

Yes, if the GitHub CLI (gh) is authenticated, the skill can extract release notes from your changelog and create tags and GitHub releases in one flow.

Which git branches are affected by this workflow?

The workflow primarily operates on the 'main' branch for preparation and fast-forwards the 'docker' branch to trigger the final image publishing workflow.

Codex Release Workflow

Name: Codex Release Workflow
Author: graysurf

bygraysurf

0•

Deployment & DevOps

Automates the release lifecycle for Codex workspaces by enforcing E2E testing gates and synchronizing upstream dependencies.

This skill provides a structured, project-specific workflow for releasing the codex-workspace-launcher. It ensures high-quality releases by mandating local Docker-based E2E testing before any publish action, automatically documenting upstream dependency versions in the CHANGELOG, and managing git branch synchronization. It is specifically designed for developers maintaining Codex environments who need to maintain strict versioning standards and verify functional integrity across a matrix of environments before triggering deployment pipelines.

Key Features

01Branch-based deployment automation via fast-forward merges

02Mandatory Docker E2E gate to prevent broken releases

03Pre-release audit checks for versioning and workspace cleanliness

04Integrated support for GitHub CLI tagging and release creation

050 GitHub stars

06Automated CHANGELOG updates with upstream dependency pinning

Use Cases

01Automating the synchronization between development and deployment branches

02Managing complex releases that require specific upstream dependency tracking

03Ensuring local environment parity with production through real-Docker testing

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add graysurf/codex-workspace-launcher release-workflow

For use in Claude.ai and ChatGPT

Download Skill