Skip to content

Add Codex plugin packaging with dual install modes#31

Merged
yimwoo merged 2 commits intomainfrom
hotl/codex-plugin-packaging
Mar 27, 2026
Merged

Add Codex plugin packaging with dual install modes#31
yimwoo merged 2 commits intomainfrom
hotl/codex-plugin-packaging

Conversation

@yimwoo
Copy link
Copy Markdown
Owner

@yimwoo yimwoo commented Mar 27, 2026

Summary

  • Add .codex-plugin/plugin.json and .codex-plugin/marketplace.json so HOTL can be installed as a native Codex plugin alongside the existing native-skills symlink path
  • Add install.sh --codex-plugin (user-global) and --codex-plugin --local (repo-local) for marketplace registration
  • Scope update.sh and update.ps1 to native-skills only with plugin detection warnings, --status flag, and coexistence guidance
  • Plugin-first documentation in README.md and docs/README.codex.md with clear "Native Skills Install" vs "Plugin Install" sections
  • Version parity smoke tests extended to cover both new .codex-plugin/ manifests

Key design decisions

  • Single canonical skills/ directory — plugin manifest points at ../skills/, no Codex-specific copy
  • Plugin updates are Codex-managed; update.sh stays native-skills only
  • Git URL source only for marketplace entries (no local-path plugin source)
  • Coexistence warnings when both Codex install modes are detected

Test plan

  • bats test/smoke.bats passes (43/43)
  • install.sh --help shows new flags
  • install.sh default path unchanged (diff verified)
  • Version parity across all 6 manifest files
  • No references to ~/.codex/plugins/cache in updater scripts

🤖 Generated with Claude Code

yimwoo and others added 2 commits March 26, 2026 17:47
Package HOTL as a native Codex plugin with .codex-plugin/ manifests,
install.sh --codex-plugin flag for marketplace registration, and
plugin-first documentation across README.md and docs/README.codex.md.
Native skills install remains as fallback for dev and older Codex.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Rename Codex messaging from "plugin" to "native-skills install" in
update.sh and update.ps1. Add marketplace detection that warns when
HOTL is registered as a Codex plugin (user-global or repo-local).
Add --status flag for read-only install mode reporting. Add coexistence
warnings to install.sh, updaters, and docs when both Codex modes exist.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@yimwoo yimwoo merged commit b0c97c2 into main Mar 27, 2026
1 check failed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant