Skip to content

feat: add native Codex plugin support - #15

Open
jdehorty wants to merge 2 commits into
mainfrom
agent/codex-plugin-support
Open

feat: add native Codex plugin support#15
jdehorty wants to merge 2 commits into
mainfrom
agent/codex-plugin-support

Conversation

@jdehorty

Copy link
Copy Markdown
Contributor

Summary

  • add the native .codex-plugin/plugin.json manifest for the existing skills, SessionStart hook, and Chrome DevTools MCP server
  • add a Codex marketplace catalog at .agents/plugins/marketplace.json using the Git-backed repository-root plugin source
  • put Codex support first in Quick Start with a single copy-paste marketplace-and-plugin install command
  • present Codex and Claude Code as equal native plugin targets in compatibility and repository-layout documentation

Why

The repository already offers streamlined Claude Code marketplace discovery, but Codex users do not have equivalent plugin metadata or an installation path. This adds native Codex discovery and installation without duplicating the canonical skills tree.

User impact

Codex users can install everything with:

codex plugin marketplace add CesiumGS/cesiumjs-skills && codex plugin add cesiumjs-skills@cesiumjs-skills

A new Codex session then loads the installed skills and tools.

Validation

  • Codex plugin validator passes
  • JSON manifests parse successfully
  • exact documented one-line flow passes against an isolated Codex home and Git mirror
  • installed plugin reports version 0.3.0 as enabled
  • SessionStart hook output parses as valid JSON
  • git diff --check passes

Closes #14

@jdehorty
jdehorty marked this pull request as ready for review July 16, 2026 05:39
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"

@arnob-mallick arnob-mallick Jul 21, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

authentication: ON_INSTALL will prompt users for credentials on install. I don't think this plugin actually needs auth for anything:

  • The only MCP server (chrome-devtools-mcp) just spawns a local headless Chrome process — no account, no API key.
  • The SessionStart hook only reads a local SKILL.md file off disk.
  • The "token" mentions in the skill docs (Ion tokens, Mapbox/ArcGIS keys) are guidance for end users writing CesiumJS apps, unrelated to installing this plugin.

Recommend removing this field (or setting it to whichever value means "not required" in Codex's schema) unless there's a Codex-specific reason for it I'm missing.

Comment thread .codex-plugin/plugin.json
"license": "Apache-2.0",
"keywords": ["cesium", "cesiumjs", "3d", "geospatial", "gis", "maps"],
"skills": "./skills/",
"mcpServers": "./.mcp.json",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Worth flagging before merge: chrome-devtools-mcp requires Chrome to already be installed — it doesn't bundle its own Chromium like Puppeteer/Playwright do (source). Claude Code also has no clean per-user opt-out today for a plugin-bundled MCP server (anthropics/claude-code#27105, #17921), so a Chrome-less user gets a failing server every session with no easy escape hatch. It's also unpinned (@latest), so every session does a fresh npx fetch.

Given the rest of this repo treats Claude/Codex integrations as additive on top of a portable Agent-Skills core, might be worth making the browser-verification tooling an opt-in/documented setup step instead of a forced install-time dependency — fails safe for people without Chrome instead of failing loud.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

If you personally find it useful, imo write a tutorial on how to set it up, but don't make browser-verification a feature of this repo.

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.

[Feature] Add support for discovery as a Codex plugin

3 participants