Skip to content

Add Codex plugin (.codex-plugin) to drive AgentBox from Codex#72

Merged
madarco merged 3 commits into
mainfrom
add-codex-plugin
Jun 6, 2026
Merged

Add Codex plugin (.codex-plugin) to drive AgentBox from Codex#72
madarco merged 3 commits into
mainfrom
add-codex-plugin

Conversation

@madarco
Copy link
Copy Markdown
Owner

@madarco madarco commented Jun 6, 2026

Adds a .codex-plugin/ bundle so AgentBox can be installed as an OpenAI Codex plugin (mirrors the existing .claude-plugin/).

  • .codex-plugin/plugin.json — manifest (name, version, repository, MIT, interface/composerIcon, skills).
  • .codex-plugin/skills/agentbox/SKILL.md — host-side skill teaching Codex to drive the agentbox CLI (create/codex/dashboard/parallel boxes, access, lifecycle, relay).
  • .codex-plugin/assets/icon.svg — 512×512 marketplace icon.

Enables submission to the Codex plugin marketplace (hashgraph-online/awesome-codex-plugins). Does not touch any runtime code.


Note

Low Risk
Documentation and plugin metadata only; no changes to AgentBox runtime, auth, or data paths.

Overview
Adds a .codex-plugin/ bundle so AgentBox can be installed as an OpenAI Codex plugin, parallel to the existing Claude plugin layout.

The manifest (plugin.json) registers name, version, MIT license, UI copy, composer icon path, and a skills directory. The agentbox skill (skills/agentbox/SKILL.md) instructs Codex to run on the host and drive the agentbox CLI—create boxes, launch Codex/Claude/OpenCode in sandboxes, parallel runs, dashboard attach, tunnels, and lifecycle/relay behavior. A 512×512 icon.svg supplies the marketplace/composer icon.

No application or CLI runtime code is modified; this is packaging and documentation for Codex marketplace submission only.

Reviewed by Cursor Bugbot for commit b9677e2. Configure here.

@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 6, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
agentbox-web Ready Ready Preview, Comment Jun 6, 2026 9:58am

Request Review

Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit b9677e2. Configure here.

Comment thread .codex-plugin/skills/agentbox/SKILL.md Outdated

`<box>` is optional almost everywhere — it defaults to the current project's box, or use its short index (`1`, `2`, …), name, or id prefix. Run `agentbox <command> --help` for options.

Full docs: https://agent-box.sh/docs
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Duplicate host skill drifts

Low Severity

The Codex plugin skill largely repeats the bundled agentbox-info host reference with a shorter subset. Two hand-maintained copies already disagree on pause timing and cloud setup, increasing the chance future CLI changes update only one file.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit b9677e2. Configure here.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in 027439d. Replaced the hand-copied codex skill with a symlink to the single source of truth at apps/cli/share/host-skills/agentbox-info — mirroring the existing repo-root skills/agentbox-info symlink. The two copies can no longer drift.

The codex plugin hand-copied a condensed version of the canonical
host-side skill, which Bugbot flagged as already drifting from the
source. Mirror the existing repo-root `skills/agentbox-info` pattern:
symlink the codex plugin skill to the single source of truth at
apps/cli/share/host-skills/agentbox-info, so the two can never drift.
@madarco madarco merged commit f5721ac into main Jun 6, 2026
3 checks passed
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