VeryGoodOpenSource / VeryGoodOpenSource/vgv-wingspan
feat: add support for Codex
Open
@ryzizub is already working on this.
Since Jul 21, 2026.
feature
p1
- Dominant language
- Shell
- Stars
- 105
- Forks
- 15
- Avg merge
- 13h 12m
- Merged PRs (30d)
- 2
Description
Description
Codex (https://chatgpt.com/codex). Tier-2 target under epic #66 alongside Gemini CLI.
Codex is a "universal" agent: it reads .agents/skills/ directly, so once the repo is published to the open standard (skills.sh), the workflow skills land in Codex for free. Remaining work is the hook and MCP, plus the subagent-degradation decision.
Scope
- Skills — verified to load from
.agents/skills/. - Hook — port
recommend-pluginsto Codex hooks (hooks.jsonor inline[hooks]inconfig.toml;PreToolUse/UserPromptSubmitevents). Caveats: experimental, feature-flagged ([features] codex_hooks = true), not on Windows. The host-aware version ofrecommend-plugins.shfrom PR #220 already detects non-Claude hosts and is a starting point. - MCP — wire
context7via Codex~/.codex/config.toml. - Subagents — Codex has full subagent support (GA March 2026): custom agents as TOML in
~/.codex/agents/,spawn_agent/wait_agentprimitives,/agent. Convert ouragents/*.mddefinitions to Codex TOML so the review/plan/research panels run natively. - CI — loader job asserting skills load in Codex.
Docs: https://developers.openai.com/codex/hooks
Requirements
- Skills load in Codex via
.agents/skills/ -
recommend-pluginshook ported to Codex hook format (caveats documented) -
context7MCP wired viaconfig.toml - Agent definitions converted to Codex TOML (
~/.codex/agents/); review/plan panels run natively - Codex loader CI job added
Additional Context
Part of epic #66. Tier 2 / wave 1 alongside Gemini CLI (#227) and OpenCode (#229).
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.