Skip to content

Support Codex as well as Claude Code - #4

Merged
talayash merged 1 commit into
mainfrom
codex-support
Oct 20, 2026
Merged

talayash merged 1 commit into
mainfrom
codex-support

Conversation

@talayash

Copy link
Copy Markdown
Owner

Summary

Makes the plugin installable and usable from OpenAI Codex, with one shared skill for both agents.

  • .codex-plugin/plugin.json: Codex plugin manifest ("skills": "./skills/", display metadata). Codex 0.149 reads this path; it ignores a root plugin.json (tested).
  • No new marketplace file: Codex already reads .claude-plugin/marketplace.json, so one marketplace serves both agents.
  • skills/learn/agents/openai.yaml: Codex display name and default prompt for the skill. Claude Code ignores it.
  • SKILL.md made agent-neutral: mentions /learn (Claude Code) and $learn (Codex), replaces the Claude-only <skill-base-dir> and scratchpad references, and says what to do when a sandbox blocks opening a browser.
  • Versions: npm run bump and the version test now include the Codex manifest. A new test checks the Codex manifest points at the shared skill.
  • README: Codex install (codex plugin marketplace add talayash/learn, codex plugin add learn@learn), $learn usage, manual install to ~/.agents/skills, and neutral wording.

Claude Code behaviour is unchanged.

Testing

  • npm test: 18 pass.
  • With Codex CLI 0.149.1, in a throwaway CODEX_HOME (real config untouched):
    • codex plugin marketplace add . then codex plugin add learn@learn installs at version 0.1.0.
    • App-server skills/list returns learn:learn with display name "Learn", so the skill and its openai.yaml are discovered.
    • codex sandbox -P :workspace -- node render.mjs … writes the lesson page, history.json and index.html inside Codex's sandbox.
  • Not tested: a full $learn run with a model, and the GitHub-based codex plugin marketplace add talayash/learn (needs this merged first).

🤖 Generated with Claude Code

- Add a Codex plugin manifest (.codex-plugin/plugin.json) pointing at the
  shared skills/ folder; Codex installs from the existing marketplace file
- Add agents/openai.yaml so Codex shows the skill as "Learn"
- Make SKILL.md agent-neutral: /learn or $learn, no Claude-only paths,
  and a fallback when a sandbox cannot open a browser
- Keep the Codex manifest version in sync via the bump script and tests
- Document Codex install and usage in the README

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@talayash
talayash merged commit 9b4adec into main Oct 20, 2026
4 checks passed
@talayash talayash mentioned this pull request Oct 20, 2026
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