Release Clockwork

SkillDev tools

Build and verify a signed, notarized, auto-updating Clockwork release.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Release Clockwork skill

What this skill tells your AI

The instructions your AI receives, as published by iannuttall/clockwork in .agents/skills/release/SKILL.md and read by ahel’s review.

Preflight

  1. Move user-facing changes into a dated ## X.Y.Z - YYYY-MM-DD section in CHANGELOG.md.
  2. Set the matching MARKETING_VERSION and a strictly increasing BUILD_NUMBER in version.env.
  3. Confirm Resources/AppIcon.icon contains the final artwork.
  4. Confirm the Developer ID identity, notarytool profile, and Sparkle keychain key described in docs/releasing.md are available.
  5. Run make check and commit the clean release state.

Build

Run make release. Do not run individual signing or notarization commands by hand.

The command creates:

  • .build/artifacts/Clockwork-X.Y.Z.dmg
  • .build/artifacts/Clockwork-X.Y.Z.dmg.sha256

Publish

Upload both files to a draft GitHub release tagged vX.Y.Z, then run:

make appcast ARTIFACT=.build/artifacts/Clockwork-X.Y.Z.dmg

Review and commit appcast.xml, then publish the draft release. Verify the GitHub download, checksum, appcast signature, and an update from the previous installed build. Never commit private keys or ship an unnotarized artifact.

Signals

GitHub stars
41
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
release-clockwork
Source
github.com/iannuttall/clockwork