codex-computer-use
Use this skill when a task should be completed by a separate codex exec
subprocess that can operate local Mac apps through Computer Use.
The implementation lives under scripts/:
scripts/run.ts- standalone Bun runner aroundcodex exec
Runner
Basic use:
bun .agents/skills/codex-computer-use/scripts/run.ts \
--task "Read the latest visible LINE messages. Do not reply."
Smoke-test command construction without launching Codex:
bun .agents/skills/codex-computer-use/scripts/run.ts \
--task "List currently running apps using Computer Use." \
--dry-run
Capture the final sub-agent answer:
bun .agents/skills/codex-computer-use/scripts/run.ts \
--task "Read the latest visible LINE messages. Do not reply." \
--out output/codex-computer-use/line-latest.txt
Behavior
The runner:
- Finds
codexfromCODEX_BINorPATH. - Runs
codex execin non-interactive mode. - Uses
--cd,--sandbox workspace-write,--skip-git-repo-check, and--ephemeralby default. - Writes the final sub-agent message when
--outis provided. - Injects instructions to use the
computer-useskill and avoid side effects.
Computer Use currently operates the active macOS GUI. There is no confirmed
headless/background Computer Use mode exposed by codex exec; expect foreground
app focus changes when a real GUI task runs.
Safety
Default to read/inspect-only tasks unless the user explicitly asks for UI changes. Do not send messages, submit forms, delete data, change settings, purchase, upload, or transmit sensitive data unless the user clearly requested that exact action and the Computer Use confirmation policy allows it.
For real runs, tell the user the task may focus or manipulate local apps. For
non-disruptive validation, prefer --dry-run.