# Release

> Automated release workflow for oh-my-codex

- Skill: `materialofair/release` (Agent Skill)
- Install (CLI): `npx skillmds@latest add materialofair/release`
- Raw SKILL.md: https://api.skillmd.com/api/skills/materialofair/release/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: materialofair (https://skillmd.com/u/materialofair)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/materialofair/release

---



# Release Skill


## Native Subagent Protocol (Codex)

Codex supports native subagents. Delegate with `spawn_agent`, coordinate with `send_input`, collect via `wait_agent`, and clean up with `close_agent`.

Execution preference:
1. Use native subagents first for independent workstreams (parallel when possible).
2. Merge results in main thread and run final verification.
3. Fallback only when delegation is blocked: use the `[ANALYST]`/`[ARCHITECT]`/`[EXECUTOR]`/`[REVIEWER]` structure in a single response.

Minimal orchestration pattern:
```text
spawn_agent -> send_input (optional) -> wait_agent -> close_agent
```

> Codex invocation: use `$release ...` or `release: ...`

Automate the release process for oh-my-codex.

## Usage

```
$release <version>
```

Example: `$release 0.2.0` or `$release patch` or `$release minor`

## Release Checklist

Execute these steps in order:

### 1. Version Bump
Update version in all locations:
- `package.json`
- `README.md`
- `AGENTS.md`
- `docs/CODEX.md`
- `CHANGELOG.md`

### 2. Run Tests (optional)
```bash
npm run test:run
```

### 3. Commit Version Bump
```bash
git add -A
git commit -m "chore: bump version to <version>"
```

### 4. Create & Push Tag
```bash
git tag v<version>
git push origin main
git push origin v<version>
```

### 5. Create GitHub Release
```bash
gh release create v<version> --title "v<version> - <title>" --notes "<release notes>"
```

## Version Files Reference

| File | Field/Line |
|------|------------|
| `package.json` | `"version": "X.Y.Z"` |
| `README.md` | Title/metadata |
| `AGENTS.md` | Version line |
| `docs/CODEX.md` | Version mention (if any) |
| `CHANGELOG.md` | New entry |

## Semantic Versioning

- **patch** (X.Y.Z+1): Bug fixes, minor improvements
- **minor** (X.Y+1.0): New features, backward compatible
- **major** (X+1.0.0): Breaking changes