feat(codex): install AgentBox as a Codex plugin straight from this repo#81
Merged
Conversation
Ship a single-plugin Codex marketplace so the agentbox plugin installs
straight from the source repo:
codex plugin marketplace add madarco/agentbox
codex plugin add agentbox@agentbox
Codex requires the bundle under plugins/<name>/, with skills/ and assets/
resolved relative to the plugin root (the dir containing .codex-plugin/) —
verified against the working AgiFlow/Aegis plugins and the codex CLI. So:
- Move the bundle from the repo-root .codex-plugin/ to plugins/agentbox/.
- Add .agents/plugins/marketplace.json pointing at ./plugins/agentbox.
- Fix the manifest: composerIcon now resolves (icon sits beside the bundle),
and skills is the string "./skills/" (Codex + the awesome-list generator
only honor the string form; the array was silently skipped).
The skill ships as a real copy of the canonical
apps/cli/share/host-skills/agentbox-info/SKILL.md — Codex copies the bundle on
install and does not follow a symlink pointing outside it, so the old symlink
shipped an empty skill. CI guard 'pnpm check:plugin-skill' fails on drift;
scripts/check-plugin-skill-sync.mjs --fix resyncs.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
madarco
added a commit
to madarco/awesome-codex-plugins
that referenced
this pull request
Jun 7, 2026
…ins/agentbox/ madarco/agentbox#81 relocated the Codex plugin from the repo root .codex-plugin/ to plugins/agentbox/ (self-marketplace). Update the mirror + install_url to match: - install_url -> HEAD/plugins/agentbox/.codex-plugin/plugin.json - ship the real skills/agentbox-info/SKILL.md (was a placeholder skills/agentbox/) - refresh plugin.json (skills is now the string "./skills/") + README from upstream - drop LICENSE/SECURITY.md/.codexignore (not present at the new plugin root, so the generator would not mirror them)
madarco
added a commit
that referenced
this pull request
Jun 7, 2026
…ntbox-info skill Brings in the codex-self-marketplace work (PR #81). nightly updated the canonical apps/cli/share/host-skills/agentbox-info/SKILL.md with the Notion + Linear integration sections, so the merge runs check-plugin-skill-sync --fix to bring plugins/agentbox/skills/agentbox-info/SKILL.md back in sync.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Makes this repo a single-plugin Codex marketplace so AgentBox installs directly from source — no dependency on any "awesome" list:
Why the layout changed
Codex's marketplace requires the bundle under
plugins/<name>/, and resolvesskills/composerIconrelative to the plugin root (the dir containing.codex-plugin/) — verified against the workingAgiFlow/ai-pluginandGanyuanRan/Aegisplugins and reproduced locally withcodex-cli 0.134.0.The previous repo-root
.codex-plugin/didn't satisfy this:composerIcon: ./assets/icon.svgresolved to a non-existent repo-rootassets/(icon was nested inside.codex-plugin/assets/) → broken icon.skillswas an array["./skills/"]; Codex and the marketplace generators only honor the string form → silently skipped.Changes
.codex-plugin/→plugins/agentbox/(.codex-plugin/plugin.json+assets/icon.svg+skills/agentbox-info/)..agents/plugins/marketplace.json→source.path: ./plugins/agentbox.skillsis now"./skills/";composerIconresolves (icon sits beside the bundle).apps/cli/share/host-skills/agentbox-info/SKILL.md.scripts/check-plugin-skill-sync.mjs+pnpm check:plugin-skill, wired into CI;--fixresyncs after editing the canonical skill..claude-plugin/+ rootskills/) is untouched.Verified
codex plugin marketplace add→codex plugin add agentbox@agentboxinstalls with.codex-plugin/plugin.json,assets/icon.svg, andskills/agentbox-info/SKILL.mdall present in the plugin cache. Drift guard passes in-sync, fails on drift (exit 1), and--fixrestores.Note
Low Risk
Packaging and CI-only checks; no changes to CLI runtime, relay, or auth flows.
Overview
Turns the repo into a single-plugin Codex marketplace so users can
codex plugin marketplace add madarco/agentboxand install AgentBox from this source.The Codex bundle now lives under
plugins/agentbox/(manifest, icon, skills) instead of a repo-root layout that brokecomposerIconpaths andskillsloading (array vs string). Theagentbox-infoskill is shipped as a byte-for-byte copy ofapps/cli/share/host-skills/agentbox-info/SKILL.mdbecause Codex copies the bundle and does not follow external symlinks — the old.codex-plugin/skills/agentbox-infosymlink is removed..agents/plugins/marketplace.jsonregisters the local plugin path.scripts/check-plugin-skill-sync.mjspluspnpm check:plugin-skill(wired into CI) fail if the bundle copy drifts from canonical;--fixresyncs after editing the CLI skill.Reviewed by Cursor Bugbot for commit 7421628. Configure here.