feat: add Codex support via .agents/ skill files and runner#170
Open
pratham8431 wants to merge 1 commit intosantifer:mainfrom
Open
feat: add Codex support via .agents/ skill files and runner#170pratham8431 wants to merge 1 commit intosantifer:mainfrom
pratham8431 wants to merge 1 commit intosantifer:mainfrom
Conversation
.gitignore AGENTS.md CLAUDE.md docs/CODEX.md package.json git commit -m "feat: add Codex support via .agents/ skill files and runner - Add .agents/ with 15 prompt files mirroring Claude Code commands - Add codex-runner.mjs: bridges .agents/ files to the Codex CLI, with prompt caching, run logging, and safe argument handling - Add validate-agents.mjs: sync checker between .agents/ and modes/ - Update AGENTS.md, CLAUDE.md, docs/CODEX.md with usage and limitations - Add npm scripts: codex:scan, codex:evaluate, codex:validate, etc."
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.
Closes #<165>
What this adds
Codex doesn't have a native skill-loading mechanism like Claude Code's
/career-ops commands. This PR adds a complete execution layer:
.agents/— 15 prompt files (one per command) that instruct Codex toload the correct
modes/files, matching the Claude Code skill 1-to-1codex-runner.mjs— CLI bridge that reads an agent file, substitutesarguments safely, and invokes the Codex CLI. Falls back gracefully:
caches the prompt to
.agents/cache/and logs the run toruns/codex-runs.jsonlvalidate-agents.mjs— sync checker: errors if.agents/referencesa
modes/file that doesn't exist, catches silent divergencenpm run codex:*shortcuts for the most common commandsAGENTS.md,CLAUDE.md,docs/CODEX.mdwith usage examples,command table, and an honest Limitations section
Testing
node codex-runner.mjs --help # usage
node codex-runner.mjs scan # fallback path (caches prompt, logs run)
node validate-agents.mjs # all checks pass
npm run codex:validate