[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BJ5DHM24PBGC2C94DWK3SV":3,"skill-same:01M7BJ5DHM24PBGC2C94DWK3SV":61},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":40,"commitSha":41,"skillDirectory":42,"forksCount":13,"repositoryHtmlUrl":43,"repositoryHomepageUrl":6,"ownerHtmlUrl":44,"ownerBlogUrl":45,"ownerDescription":6,"updatedAt":46,"install":47,"resources":60},"01M7BJ5DHM24PBGC2C94DWK3SV","codex",null,"Delegate coding to OpenAI Codex CLI (features, PRs).","darkmatter\u002Fhermes","darkmatter","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F17834193?v=4","01M7BHSAW99WRAMTSSHNHX73V0","01M7BHSAXDR4PY4NA2DY5PN6W8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fdevbox\u002Fprofiles\u002Fworker\u002Fskills\u002Fautonomous-ai-agents\u002Fcodex\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: codex\ndescription: \"Delegate coding to OpenAI Codex CLI (features, PRs).\"\nversion: 1.0.1\nauthor: Hermes Agent\nlicense: MIT\nplatforms: [linux, macos, windows]\nmetadata:\n  hermes:\n    tags: [Coding-Agent, Codex, OpenAI, Code-Review, Refactoring]\n    related_skills: [claude-code, hermes-agent]\n---\n\n# Codex CLI\n\nDelegate coding tasks to [Codex](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex) via the Hermes terminal. Codex is OpenAI's autonomous coding agent CLI.\n\n## When to use\n\n- Building features\n- Refactoring\n- PR reviews\n- Batch issue fixing\n\nRequires the codex CLI and a git repository.\n\n## Prerequisites\n\n- Codex installed: `npm install -g @openai\u002Fcodex`\n- OpenAI auth configured: either `OPENAI_API_KEY` or Codex OAuth credentials\n  from the Codex CLI login flow\n- **Must run inside a git repository** — Codex refuses to run outside one\n- Use `pty=true` in terminal calls — Codex is an interactive terminal app\n\nFor Hermes itself, `model.provider: openai-codex` uses Hermes-managed Codex\nOAuth from `~\u002F.hermes\u002Fauth.json` after `hermes auth add openai-codex`. For the\nstandalone Codex CLI, a valid CLI OAuth session may live under\n`~\u002F.codex\u002Fauth.json`; do not treat a missing `OPENAI_API_KEY` alone as proof\nthat Codex auth is missing.\n\n## One-Shot Tasks\n\n```\nterminal(command=\"codex exec 'Add dark mode toggle to settings'\", workdir=\"~\u002Fproject\", pty=true)\n```\n\nFor scratch work (Codex needs a git repo):\n```\nterminal(command=\"cd $(mktemp -d) && git init && codex exec 'Build a snake game in Python'\", pty=true)\n```\n\n## Background Mode (Long Tasks)\n\n```\n# Start in background with PTY\nterminal(command=\"codex exec --sandbox workspace-write 'Refactor the auth module'\", workdir=\"~\u002Fproject\", background=true, pty=true)\n# Returns session_id\n\n# Monitor progress\nprocess(action=\"poll\", session_id=\"\u003Cid>\")\nprocess(action=\"log\", session_id=\"\u003Cid>\")\n\n# Send input if Codex asks a question\nprocess(action=\"submit\", session_id=\"\u003Cid>\", data=\"yes\")\n\n# Kill if needed\nprocess(action=\"kill\", session_id=\"\u003Cid>\")\n```\n\n## Key Flags\n\n| Flag | Effect |\n|------|--------|\n| `exec \"prompt\"` | One-shot execution, exits when done |\n| `--sandbox workspace-write` (`-s`) | Sandboxed but auto-approves file changes in the workspace (the recommended auto-build mode) |\n| `--dangerously-bypass-approvals-and-sandbox` | No sandbox, no approvals (fastest, most dangerous; `--yolo` still works as a hidden alias) |\n| `--sandbox danger-full-access` | No Codex sandbox; useful when the host service context breaks bubblewrap |\n\n> **Deprecated:** `--full-auto` still works but the live CLI warns to use `--sandbox workspace-write` instead.\n\n## Hermes Gateway Caveat\n\nWhen invoking the Codex CLI from a Hermes gateway\u002Fservice context (for example,\nTelegram-driven agent sessions), Codex `workspace-write` sandboxing may fail even\nwhen the same command works in the user's interactive shell. A typical symptom is\nbubblewrap\u002Fuser-namespace errors such as `setting up uid map: Permission denied`\nor `loopback: Failed RTM_NEWADDR: Operation not permitted`.\n\nIn that context, prefer:\n\n```\ncodex exec --sandbox danger-full-access \"\u003Ctask>\"\n```\n\nUse process boundaries as the safety layer instead: explicit `workdir`, clean git\nstatus before launch, narrow task prompts, `git diff` review, targeted tests, and\nhuman\u002Fagent confirmation before committing broad changes.\n\n## PR Reviews\n\nClone to a temp directory for safe review:\n\n```\nterminal(command=\"REVIEW=$(mktemp -d) && git clone https:\u002F\u002Fgithub.com\u002Fuser\u002Frepo.git $REVIEW && cd $REVIEW && gh pr checkout 42 && codex review --base origin\u002Fmain\", pty=true)\n```\n\n## Parallel Issue Fixing with Worktrees\n\n```\n# Create worktrees\nterminal(command=\"git worktree add -b fix\u002Fissue-78 \u002Ftmp\u002Fissue-78 main\", workdir=\"~\u002Fproject\")\nterminal(command=\"git worktree add -b fix\u002Fissue-99 \u002Ftmp\u002Fissue-99 main\", workdir=\"~\u002Fproject\")\n\n# Launch Codex in each\nterminal(command=\"codex --sandbox workspace-write exec 'Fix issue #78: \u003Cdescription>. Commit when done.'\", workdir=\"\u002Ftmp\u002Fissue-78\", background=true, pty=true)\nterminal(command=\"codex --sandbox workspace-write exec 'Fix issue #99: \u003Cdescription>. Commit when done.'\", workdir=\"\u002Ftmp\u002Fissue-99\", background=true, pty=true)\n\n# Monitor\nprocess(action=\"list\")\n\n# After completion, push and create PRs\nterminal(command=\"cd \u002Ftmp\u002Fissue-78 && git push -u origin fix\u002Fissue-78\")\nterminal(command=\"gh pr create --repo user\u002Frepo --head fix\u002Fissue-78 --title 'fix: ...' --body '...'\")\n\n# Cleanup\nterminal(command=\"git worktree remove \u002Ftmp\u002Fissue-78\", workdir=\"~\u002Fproject\")\n```\n\n## Batch PR Reviews\n\n```\n# Fetch all PR refs\nterminal(command=\"git fetch origin '+refs\u002Fpull\u002F*\u002Fhead:refs\u002Fremotes\u002Forigin\u002Fpr\u002F*'\", workdir=\"~\u002Fproject\")\n\n# Review multiple PRs in parallel\nterminal(command=\"codex exec 'Review PR #86. git diff origin\u002Fmain...origin\u002Fpr\u002F86'\", workdir=\"~\u002Fproject\", background=true, pty=true)\nterminal(command=\"codex exec 'Review PR #87. git diff origin\u002Fmain...origin\u002Fpr\u002F87'\", workdir=\"~\u002Fproject\", background=true, pty=true)\n\n# Post results\nterminal(command=\"gh pr comment 86 --body '\u003Creview>'\", workdir=\"~\u002Fproject\")\n```\n\n## Rules\n\n1. **Always use `pty=true`** — Codex is an interactive terminal app and hangs without a PTY\n2. **Git repo required** — Codex won't run outside a git directory. Use `mktemp -d && git init` for scratch\n3. **Use `exec` for one-shots** — `codex exec \"prompt\"` runs and exits cleanly\n4. **`--sandbox workspace-write` for building** — auto-approves changes within the sandbox (`--full-auto` is deprecated for this)\n5. **Background for long tasks** — use `background=true` and monitor with `process` tool\n6. **Don't interfere** — monitor with `poll`\u002F`log`, be patient with long-running tasks\n7. **Parallel is fine** — run multiple Codex processes at once for batch work\n","# Codex CLI\n\nDelegate coding tasks to [Codex](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex) via the Hermes terminal. Codex is OpenAI's autonomous coding agent CLI.\n\n## When to use\n\n- Building features\n- Refactoring\n- PR reviews\n- Batch issue fixing\n\nRequires the codex CLI and a git repository.\n\n## Prerequisites\n\n- Codex installed: `npm install -g @openai\u002Fcodex`\n- OpenAI auth configured: either `OPENAI_API_KEY` or Codex OAuth credentials\n  from the Codex CLI login flow\n- **Must run inside a git repository** — Codex refuses to run outside one\n- Use `pty=true` in terminal calls — Codex is an interactive terminal app\n\nFor Hermes itself, `model.provider: openai-codex` uses Hermes-managed Codex\nOAuth from `~\u002F.hermes\u002Fauth.json` after `hermes auth add openai-codex`. For the\nstandalone Codex CLI, a valid CLI OAuth session may live under\n`~\u002F.codex\u002Fauth.json`; do not treat a missing `OPENAI_API_KEY` alone as proof\nthat Codex auth is missing.\n\n## One-Shot Tasks\n\n```\nterminal(command=\"codex exec 'Add dark mode toggle to settings'\", workdir=\"~\u002Fproject\", pty=true)\n```\n\nFor scratch work (Codex needs a git repo):\n```\nterminal(command=\"cd $(mktemp -d) && git init && codex exec 'Build a snake game in Python'\", pty=true)\n```\n\n## Background Mode (Long Tasks)\n\n```\n# Start in background with PTY\nterminal(command=\"codex exec --sandbox workspace-write 'Refactor the auth module'\", workdir=\"~\u002Fproject\", background=true, pty=true)\n# Returns session_id\n\n# Monitor progress\nprocess(action=\"poll\", session_id=\"\u003Cid>\")\nprocess(action=\"log\", session_id=\"\u003Cid>\")\n\n# Send input if Codex asks a question\nprocess(action=\"submit\", session_id=\"\u003Cid>\", data=\"yes\")\n\n# Kill if needed\nprocess(action=\"kill\", session_id=\"\u003Cid>\")\n```\n\n## Key Flags\n\n| Flag | Effect |\n|------|--------|\n| `exec \"prompt\"` | One-shot execution, exits when done |\n| `--sandbox workspace-write` (`-s`) | Sandboxed but auto-approves file changes in the workspace (the recommended auto-build mode) |\n| `--dangerously-bypass-approvals-and-sandbox` | No sandbox, no approvals (fastest, most dangerous; `--yolo` still works as a hidden alias) |\n| `--sandbox danger-full-access` | No Codex sandbox; useful when the host service context breaks bubblewrap |\n\n> **Deprecated:** `--full-auto` still works but the live CLI warns to use `--sandbox workspace-write` instead.\n\n## Hermes Gateway Caveat\n\nWhen invoking the Codex CLI from a Hermes gateway\u002Fservice context (for example,\nTelegram-driven agent sessions), Codex `workspace-write` sandboxing may fail even\nwhen the same command works in the user's interactive shell. A typical symptom is\nbubblewrap\u002Fuser-namespace errors such as `setting up uid map: Permission denied`\nor `loopback: Failed RTM_NEWADDR: Operation not permitted`.\n\nIn that context, prefer:\n\n```\ncodex exec --sandbox danger-full-access \"\u003Ctask>\"\n```\n\nUse process boundaries as the safety layer instead: explicit `workdir`, clean git\nstatus before launch, narrow task prompts, `git diff` review, targeted tests, and\nhuman\u002Fagent confirmation before committing broad changes.\n\n## PR Reviews\n\nClone to a temp directory for safe review:\n\n```\nterminal(command=\"REVIEW=$(mktemp -d) && git clone https:\u002F\u002Fgithub.com\u002Fuser\u002Frepo.git $REVIEW && cd $REVIEW && gh pr checkout 42 && codex review --base origin\u002Fmain\", pty=true)\n```\n\n## Parallel Issue Fixing with Worktrees\n\n```\n# Create worktrees\nterminal(command=\"git worktree add -b fix\u002Fissue-78 \u002Ftmp\u002Fissue-78 main\", workdir=\"~\u002Fproject\")\nterminal(command=\"git worktree add -b fix\u002Fissue-99 \u002Ftmp\u002Fissue-99 main\", workdir=\"~\u002Fproject\")\n\n# Launch Codex in each\nterminal(command=\"codex --sandbox workspace-write exec 'Fix issue #78: \u003Cdescription>. Commit when done.'\", workdir=\"\u002Ftmp\u002Fissue-78\", background=true, pty=true)\nterminal(command=\"codex --sandbox workspace-write exec 'Fix issue #99: \u003Cdescription>. Commit when done.'\", workdir=\"\u002Ftmp\u002Fissue-99\", background=true, pty=true)\n\n# Monitor\nprocess(action=\"list\")\n\n# After completion, push and create PRs\nterminal(command=\"cd \u002Ftmp\u002Fissue-78 && git push -u origin fix\u002Fissue-78\")\nterminal(command=\"gh pr create --repo user\u002Frepo --head fix\u002Fissue-78 --title 'fix: ...' --body '...'\")\n\n# Cleanup\nterminal(command=\"git worktree remove \u002Ftmp\u002Fissue-78\", workdir=\"~\u002Fproject\")\n```\n\n## Batch PR Reviews\n\n```\n# Fetch all PR refs\nterminal(command=\"git fetch origin '+refs\u002Fpull\u002F*\u002Fhead:refs\u002Fremotes\u002Forigin\u002Fpr\u002F*'\", workdir=\"~\u002Fproject\")\n\n# Review multiple PRs in parallel\nterminal(command=\"codex exec 'Review PR #86. git diff origin\u002Fmain...origin\u002Fpr\u002F86'\", workdir=\"~\u002Fproject\", background=true, pty=true)\nterminal(command=\"codex exec 'Review PR #87. git diff origin\u002Fmain...origin\u002Fpr\u002F87'\", workdir=\"~\u002Fproject\", background=true, pty=true)\n\n# Post results\nterminal(command=\"gh pr comment 86 --body '\u003Creview>'\", workdir=\"~\u002Fproject\")\n```\n\n## Rules\n\n1. **Always use `pty=true`** — Codex is an interactive terminal app and hangs without a PTY\n2. **Git repo required** — Codex won't run outside a git directory. Use `mktemp -d && git init` for scratch\n3. **Use `exec` for one-shots** — `codex exec \"prompt\"` runs and exits cleanly\n4. **`--sandbox workspace-write` for building** — auto-approves changes within the sandbox (`--full-auto` is deprecated for this)\n5. **Background for long tasks** — use `background=true` and monitor with `process` tool\n6. **Don't interfere** — monitor with `poll`\u002F`log`, be patient with long-running tasks\n7. **Parallel is fine** — run multiple Codex processes at once for batch work\n",{"name":5,"author":23,"license":14,"version":24,"metadata":25,"platforms":36,"description":7},"Hermes Agent","1.0.1",{"hermes":26},{"tags":27,"related_skills":33},[28,29,30,31,32],"Coding-Agent","Codex","OpenAI","Code-Review","Refactoring",[34,35],"claude-code","hermes-agent",[37,38,39],"linux","macos","windows","main","81189f70e1089f9b3a944ffc480e6887efd831b9","devbox\u002Fprofiles\u002Fworker\u002Fskills\u002Fautonomous-ai-agents\u002Fcodex","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes","https:\u002F\u002Fgithub.com\u002Fdarkmatter","dm.sh","2026-09-14 08:11:52",{"source":8,"skillName":5,"commands":48,"prompt":58,"zipAvailable":59},[49,52,55],{"tool":50,"command":51},"npx","npx skills add darkmatter\u002Fhermes --skill codex",{"tool":53,"command":54},"bunx","bunx skills add darkmatter\u002Fhermes --skill codex",{"tool":56,"command":57},"pnpm","pnpm dlx skills add darkmatter\u002Fhermes --skill codex","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fdevbox\u002Fprofiles\u002Fworker\u002Fskills\u002Fautonomous-ai-agents\u002Fcodex\u002FSKILL.md",true,[],[62,69,76,83,90,97],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":18},"01M7BMC2PYBVXM6FQEZMBQZB4G","plan","Write a markdown plan to .hermes\u002Fplans\u002F; no execution.","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fplan\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":18},"01M7BMBSEKDVQ09Z666RCWT7BR","monorepo-fleet-sync","Sync docs and configs when a Flue monorepo fleet changes.","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fmonorepo-fleet-sync\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":18},"01M7BMBNWFJT2TJZ2AKA64GEV9","inspecting-hermes-desktop-dom","Read the live Hermes desktop DOM\u002FCSS over CDP.","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Finspecting-hermes-desktop-dom\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":18},"01M7BMAZM4VJ97K7JD0FDN58M8","grounded-citations","Ground answers and documents in cited, verifiable sources.","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fgrounded-citations\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":18},"01M7BMATPEDZ4BPP67Y4ZS0BMM","competitor-news-monitor","Watch named companies for material news; cited digests.","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fcompetitor-news-monitor\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":18},"01M7BMAQZV7YFA2SFPT7HCVCTX","blocked-page-recovery","Recover blocked\u002Fpaywalled\u002FWAF'd pages via fallbacks.","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fblocked-page-recovery\u002FSKILL.md",[],[]]