Publish a release
Source of truth: docs/publish.md.
Do not start unless asked
Never bump versions, create tags, or open GitHub Releases unless the user asked to publish.
Steps
- Confirm
mainis the intended tree (docs / product work merged as requested). - Confirm
.mcp.jsonis still the unpinned npx shape (never a localdist/path). - Bump the same version in
package.json(and the lockfile),plugin.json, and.cursor-plugin/plugin.json. Tag will bevplus that version.@dustinestes/clockify-mcp-server@0.1.0is leftover under the old npm name — do not republish it. First publish of@dustinestes/clockify-agent-pluginmay be0.1.0. npm run check:versions- Commit, open a PR if not already on
main, merge. - After merge:
gh release create vX.Y.Z --generate-notes(not a draft, not a prerelease). - Wait for
.github/workflows/publish.yml. Verifynpm view @dustinestes/clockify-agent-plugin version. - Handshake:
npx -y @dustinestes/clockify-agent-plugin(stdio; idle until Ctrl+C).
Owner-only (stop)
The agent cannot do these. Point at docs/publish.md and wait.
- npm Trusted Publisher (one-time): npmjs.com → package → Trusted Publisher → GitHub Actions, workflow filename
publish.yml. - cursor.directory: first listing is the website form; later skill/catalog changes are Edit, never a second submit. No publisher API.
Directory
Directory snapshots GitHub HEAD and ignores tags. Do not submit the first listing until npm latest matches this tree.