Agent skill · mia-cx
codex-computer-use
Use when the user asks to test a flow, verify UI behavior, inspect a running app, or capture screenshots.
What it needs
About 2k tokens when loaded.
What this skill does
Codex Computer Use Use Codex as a separate local verification agent when the task needs real UI interaction, screenshots, simulator/browser/device state, or an independent runtime check outside the current context. For code reading, typechecking, linting, or tests, run them directly instead — no computer use needed. Launching apps, simulators, or browsers to verify the requested work is fine without asking; ask first only if the run could disrupt the user's environment beyond that (closing their apps, changing system settings, acting on real accounts or data). Environment Capability depends on where this runs — check before dispatching: Browser automation (the common case): the codex CLI drives Chrome via CDP (browseruse feature, stable and enabled). Needs Chrome and a display; works on the laptop, not on a headless devbox. Full OS control (native apps, simulators, cross-app flows): requires the Codex desktop app on macOS or Windows — macOS needs Screen Recording + Accessibility permissions. Linux is unsupported. Headless environment (no display/Chrome): report that computer use is unavailable and fall back to non-GUI verification — curl the endpoints, run the test suite, read logs. Workflow 1. Confirm the target is reachable: app running, URL or app name known, test credentials if the flow needs them. 2. Create a temporary artifact directory; write the verification prompt to $ARTIFACTDIR/prompt.md. 3. Run codex exec: Set the Codex working root to the temporary artifact directory. This keeps workspace-write available for screenshots and the report without making the source repository writable. Computer-use runs are long: pass an explicit Bash timeout, or run in the background and poll for $ARTIFACTDIR/report.md. Verification Prompt Keep it simple and self-contained: Keep "do not edit" — the 5.6 models (sol especially) are eager to start fixing what they find broken. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills mia-cx/codex-computer-use