| name | run-agmente-codex-e2e |
| description | Run Agmente iOS end-to-end tests against a local Codex app-server endpoint, validate Codex thread/turn protocol flow, and perform mandatory cleanup. |
Run Agmente Codex App-Server E2E
Use this skill when the user asks to run Agmente E2E against OpenAI Codex app-server.
Inputs
scenario: sanity (default), add-server, turn-send
port: default 9000
simulatorID: default BE205EA8-B26C-44C2-B52B-B49141678273
codexCommand: default codex app-server (override via first arg to start_codex.sh or CODEX_APP_SERVER_CMD)
npxTag: package tag for @rebornix/stdio-to-ws (latest by default, override via third arg or AGMENTE_E2E_NPX_TAG)
Workflow
- Start local Codex bridge in background:
./.github/skills/run-agmente-codex-e2e/scripts/start_codex.sh "<codexCommand>" <port> <npxTag>
- Build and run in simulator:
- Use XcodeBuildMCP
build_run_sim with Agmente defaults.
- Execute UI steps:
- Follow
references/ui-checklist.md.
- Set server type to
Codex App-Server.
- Call
describe_ui before each tap.
- Prefer tap by
id or label.
- Validate protocol behavior from bridge logs:
- Confirm sequence:
initialize -> initialized -> thread/list -> thread/start -> turn/start -> turn/started -> turn/completed.
- Confirm streamed notifications arrive (
item/* and/or codex/event/*).
- Cleanup always (success or failure):
./.github/skills/run-agmente-codex-e2e/scripts/cleanup.sh <simulatorID> <port>
Constraints
- Do not skip cleanup.
- Use a valid host working directory (for example
/path/to/your/workspace).
- Do not rely on guessed coordinates from screenshots.
- Prefer deterministic selectors and
describe_ui.
References
- UI and validation checklist:
references/ui-checklist.md