Back to Oh My Openagent

Publishing the lazycodex-ai npm name (publish playbook)

docs/reference/lazycodex-npm-reservation.md

4.6.01.5 KB
Original Source

Publishing the lazycodex-ai npm name (publish playbook)

lazycodex-ai is the npm package and bin alias for the Codex CLI Light edition. lazycodex (without the -ai suffix) is the GitHub repository that hosts the native Codex marketplace bundle. Neither is the marketplace identity. Codex installs marketplace sisyphuslabs and plugin omo, enabled as omo@sisyphuslabs.

The bare lazycodex npm name was unpublished on 2026-05-30 and is no longer installable. Use lazycodex-ai for all npm/bin references.

The publish.yml workflow includes lazycodex-ai in trusted-publisher preflight, but that check is soft for first publish. If lazycodex-ai is not yet claimed on npm, the workflow warns and continues so existing package releases are not blocked. To claim the name, run a one-time manual npm publish for lazycodex-ai from a trusted environment (for example local shell with NPM_AUTH_TOKEN). After the first manual publish, configure GitHub Actions trusted publishing at: https://www.npmjs.com/package/lazycodex-ai/access Set Provider to GitHub Actions, Organization to code-yeongyu, Repository to oh-my-openagent, and Workflow filename to publish.yml. After this setup, subsequent releases from publish.yml can publish lazycodex-ai automatically.

The same release workflow also syncs packages/omo-codex/marketplace.json and packages/omo-codex/plugin/ into code-yeongyu/lazycodex as .agents/plugins/marketplace.json and plugins/omo/. That cross-repo push requires the LAZYCODEX_SYNC_TOKEN repository secret.