codex-exec

Featured

Run one caller-supplied Codex command non-interactively and capture evidence. Triggers: "run Codex headless", "capture Codex evidence".

AI & Automation 414 stars 40 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 96/100

Stars 20%
87
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Codex Exec — one-shot runtime adapter Run exactly one caller-supplied Codex prompt and capture its result. This skill does not choose work, retry failures, validate by itself, or control continuation. One prompt, one process, one captured artifact is what makes the run auditable: when nothing loops, every byte of output traces to exactly one invocation, and a disagreement about what happened is settled by the artifact. Named failure mode — **stdin hang**: a non-TTY run left waiting forever on an open stdin nobody will write to; always pipe the prompt or close the stream. Anti-pattern: granting workspace-write or network access "in case the prompt needs it". Corrective: match the sandbox to the declared effects; a review prompt runs read-only, full stop. ## Procedure 1. Confirm `codex login status` for the intended profile. 2. Set the working root explicitly with `-C`. 3. Match the sandbox to the requested effects: read-only for offline review, workspace-write for authorized edits, and broader access only when the caller explicitly requires network or external effects. 4. Pipe the prompt to stdin (or close stdin) in non-TTY execution so the process cannot wait indefinitely for input. 5. Capture the final response with `-o`, JSONL, or an output schema. 6. Report the process exit status and captured artifact, then stop. A nonzero process exit is runtime evidence, not a semantic verdict. The caller decides whether to launch another invocation. ## Example ```ba...

Details

Author
boshu2
Repository
boshu2/agentops
Created
8 months ago
Last Updated
today
Language
Go
License
Apache-2.0

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category