codex-adapter

codex-adapter is a skill for Claude Code, Codex from wrg32786/aigent-os. It costs 101 tokens per session (882 once invoked), scanned A, original, MIT.

A controlled handoff that sends one small, clearly defined coding task to the Codex command-line tool for execution.

In plain words
What is it for?
Use it for mechanical changes such as renaming symbols, updating configuration, repeating a simple edit across files, or applying lint fixes.
Why use it?
It prevents open-ended or high-risk work from being delegated without a clear result that someone can review.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/wrg32786/aigent-os/codex-adapter
Any agent
npx skills add wrg32786/aigent-os --skill codex-adapter
Clone the repo
git clone --depth 1 https://github.com/wrg32786/aigent-os

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for codex-adapter

README.md
[![agentmods](https://agentmods.dev/badge/skills/wrg32786/aigent-os/codex-adapter.svg)](https://agentmods.dev/skills/wrg32786/aigent-os/codex-adapter)
Your own site
<a href="https://agentmods.dev/skills/wrg32786/aigent-os/codex-adapter"><img src="https://agentmods.dev/badge/skills/wrg32786/aigent-os/codex-adapter.svg" alt="Measured on agentmods" height="20"></a>
Per session 101 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 882 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00101 $0.00882
Opus 5 $0.00051 $0.00441
Sonnet 5 $0.00020 $0.00176
Haiku 4.5 $0.00010 $0.00088

Measured 3d ago against content hash d5478869faf6, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

codex-adapter scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/codex-adapter/SKILL.md · 60 lines

How it starts

The opening of the file, as written. The whole thing — 60 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Codex Adapter

This is aigent-OS's first (and currently only) non-Claude executor: a thin wrapper around daemons/codex-adapter.sh that runs a single bounded, mechanical task through the Codex CLI's non-interactive codex exec mode.

Scope -- what "bounded and mechanical" means

Good fits: a scripted rename, a config/gitignore entry, a repetitive multi-file edit with a clear before/after, a lint-fix pass. The task prompt you hand it should be checkable by a human (or you) glancing at the resulting diff -- if you can't describe in one sentence what "done" looks like, it's not bounded enough for this adapter; do it yourself instead.

Not a fit: architecture decisions, anything requiring judgment about tradeoffs, anything touching credentials/secrets/production config, anything the user hasn't explicitly asked to route to Codex.

Before you invoke it

  1. Confirm the Codex CLI is actually available: command -v codex (or whatever AIGENT_CODEX_BIN is set to). If it isn't installed, tell the user instead of guessing at a path.
  2. State the bounded task in one sentence, and the target directory. If either is unclear, ask -- don't invoke on a guess.

Invocation

bash daemons/codex-adapter.sh "<bounded task prompt>" --dir <path> [--sandbox <mode>]
  • AIGENT_CODEX_BIN (env, default codex) -- path or name of the Codex CLI binary. Never hardcode a machine-specific path in the invocation; set the env var if the binary isn't on PATH.
  • --dir <path> -- working directory the task runs in. Default: current directory.
  • --sandbox <mode> -- passed through to codex exec --sandbox. Default workspace-write (Codex may read/write inside --dir, nothing wider).

Example:

AIGENT_CODEX_BIN=codex bash daemons/codex-adapter.sh \
  "Add a .gitignore entry for *.tmp files" --dir .

After it runs -- the review gate

The adapter never commits or pushes. It writes:

  • .aigent/codex-runs/<timestamp>/output.log -- the raw Codex CLI transcript
  • .aigent/codex-runs/<timestamp>/review.diff -- a working-tree diff (tracked changes + a synthetic diff for any new untracked files) if --dir is a git repository
  • .aigent/codex-runs/<timestamp>/status.txt -- git status --porcelain for the same tree

Read the full file on GitHub · 60 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 60 lines · 101 tokens per session scan A d5478869faf6

Subscribe to this mod's changes

codex-adapter is a skill published in the GitHub repository wrg32786/aigent-os (17 stars, last pushed yesterday), licensed MIT. It adds 101 tokens to every session and 882 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-01.