Agent skill

Codex Local CLI E2E

by rebornix in rebornix/Agmente

Run and debug Agmente iOS end-to-end tests against a real local Codex CLI app-server instance.

MITAuto-check passedTesting & QA

Install Codex Local CLI E2E

skills CLI
$ npx skills add rebornix/Agmente --skill codex-local-cli-e2e -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rebornix/Agmente codex-local-cli-e2e --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rebornix/Agmente.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/codex-local-cli-e2e .claude/skills/codex-local-cli-e2e && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
codex-local-cli-e2e
GitHub stars
545
Token cost
~625 tokens
SKILL.md length
222 words
Files
4 (incl. scripts, references)
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Run and debug Agmente iOS end-to-end tests against a real local Codex CLI app-server instance.

  • Validating Codex websocket/protocol compatibility
  • SKILL.md covers Overview, Workflow, Preferred Execution and Reporting Requirements
  • Runs Shell scripts from its folder; calls codex and xcrun
  • Connect/initialize/thread flows

What it does

Codex Local CLI E2E is an agent skill from rebornix/Agmente. Run and debug Agmente iOS end-to-end tests against a real local Codex CLI app-server instance. Use when validating Codex websocket/protocol compatibility, connect/initialize/thread flows, or reproducing Codex-only UI test failures with an actual local Codex server.

Its SKILL.md is about 630 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/agmente-codex-e2e-contract.md` and `scripts/run_codex_local_e2e.sh`).

It sits in Testing & QA, covering End-to-end testing, Failing and flaky tests and Realtime and WebSockets. It works with iOS and Xcode. The repository describes itself as: iOS client for coding agents via ACP or Codex app-server. The licence is MIT.

When your agent uses it

  • Validating Codex websocket/protocol compatibility
  • Connect/initialize/thread flows
  • Reproducing Codex-only UI test failures with an actual local Codex server

Example prompts

  • “/codex-local-cli-e2e”

Requirements

  • A Bash shell

What it can do on your machine

Read from SKILL.md and the folder at commit 87f224e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • codex
    • xcrun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Codex Local CLI E2E loads about 625 tokens when it runs, and up to ~902 if it reads all its reference files. Until then it costs about 71 tokens; SKILL.md has 222 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~71
When it runs · the whole SKILL.md, loaded when a task matches
~625
With references · SKILL.md plus every file in references/, read only if the agent opens them
~902

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from rebornix/Agmente at commit 87f224e, republished under its MIT licence (© rebornix). 222 words, ~625 tokens.

Download SKILL.mdSave it as .claude/skills/codex-local-cli-e2e/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
codex-local-cli-e2e
description
Run and debug Agmente iOS end-to-end tests against a real local Codex CLI app-server instance. Use when validating Codex websocket/protocol compatibility, connect/initialize/thread flows, or reproducing Codex-only UI test failures with an actual local Codex server.

Codex Local CLI E2E

Overview

Run Agmente's Codex UI E2E test against a real local codex app-server, using the repo-owned scenario spec as the source of truth, collect actionable failure details, and always clean up simulator/app-server state.

Workflow

  1. Resolve run inputs.
  • Require endpoint (for example ws://127.0.0.1:8788) and simulator UDID.
  • Decide run mode:
    • existing server: server already running.
    • managed server: start server with a provided command and stop it during cleanup.
  • Read e2e/scenarios/codex/local-cli-smoke.md.
  • Use references/agmente-codex-e2e-contract.md only for the UI-test environment-variable harness contract.
  1. Start or verify server.
  • If managed server, start the command and wait until the endpoint port is reachable.
  • If existing server, verify reachability before running tests.
  1. Run only the Codex UI E2E test.
  • Export:
    • AGMENTE_E2E_CODEX_ENABLED=1
    • AGMENTE_E2E_CODEX_ENDPOINT=<endpoint>
  • Execute targeted test only:
    • AgmenteUITests/AgmenteUITests/testCodexDirectWebSocketConnectInitializeAndSessionFlow
  1. On failure, extract root cause.
  • Parse xcodebuild output for the failing test and assertion.
  • Read .xcresult details when xcodebuild is not explicit.
  • Include failing file/line and endpoint/simulator context in the report.
  1. Always clean up.
  • Stop app-server if this run started it.
  • Uninstall app from simulator:
    • xcrun simctl uninstall <UDID> com.example.Agmente
  • Optionally shut simulator down if requested.

Preferred Execution

Use the bundled script for deterministic runs:

  • scripts/run_codex_local_e2e.sh

Managed-server example:

bash
scripts/run_codex_local_e2e.sh \
  --endpoint ws://127.0.0.1:8788 \
  --udid <SIMULATOR_UDID> \
  --start-codex-cmd "codex app-server --listen ws://127.0.0.1:8788"

Existing-server example:

bash
scripts/run_codex_local_e2e.sh \
  --endpoint ws://127.0.0.1:8788 \
  --udid <SIMULATOR_UDID>

Reporting Requirements

Always report:

  • Endpoint used.
  • Simulator UDID used.
  • Pass/fail status.
  • Failing assertion and file/line (if failed).
  • Paths to xcodebuild log and Codex server log.

© rebornix, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in .agents/skills/codex-local-cli-e2e of rebornix/Agmente.

  • SKILL.md
  • agents/openai.yaml
  • references/agmente-codex-e2e-contract.md
  • scripts/run_codex_local_e2e.sh

Open the folder on GitHubat commit 87f224e

Compare with similar skills

Codex Local CLI E2E next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Codex Local CLI E2E compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codex Local CLI E2E this skillrebornix/Agmente545—~625Automated safety check: PassMIT
MAUI UI Test Writerdotnet/maui23k—~3kAutomated safety check: PassMIT
iOS Testing Patternsconorluddy/xclaude-plugin183—~4.5kAutomated safety check: PassMIT
iOS Audio E2Ehyochan/react-native-nitro-sound961—~907Automated safety check: PassMIT
Macios Binding Creatordotnet/macios2.9k—~7.3kAutomated safety check: PassCustom licence
Cucumber and Playwright E2E Testslanggenius/dify158k—~682Automated safety check: PassCustom licence

Similar skills

  • Official

    Writes UI tests that reproduce a GitHub issue in .NET MAUI and keeps iterating until the tests actually fail, proving they catch the bug.

    23k GitHub stars~3k tokensUpdated today
    Testing & QAAuto-check passed
  • iOS Testing Patterns

    conorluddy/xclaude-plugin

    XCTest and XCUITest execution workflows and flaky test detection patterns

    183 GitHub stars~4.5k tokensUpdated 25 days ago
    Testing & QAAuto-check passed
  • iOS Audio E2E

    hyochan/react-native-nitro-sound

    Build and run device-backed iOS end-to-end checks for react-native-nitro-sound recording, playback, listeners, pause/resume, seek, speed, interruption, audio-session behavior, and rapid switching.

    961 GitHub stars~907 tokensUpdated 8 days ago
    MobileAuto-check passed
  • Official

    Create C bindings for Apple frameworks in dotnet/macios. An agent skill from dotnet/macios.

    2.9k GitHub stars~7.3k tokensUpdated today
    MobileAuto-check passed
  • Guides changes and reviews of the Cucumber and Playwright end-to-end suite under `e2e/`: feature files, step definitions, support code, tags, locators and assertions.

    158k GitHub stars~682 tokensUpdated today
    Testing & QAAuto-check passed
  • Verifies a delivery end to end by driving the real product on a CLI, web, desktop or iOS Simulator surface, capturing evidence and publishing a round with the lh CLI.

    83k GitHub stars~9.7k tokensUpdated today
    Testing & QAAuto-check passed

More from rebornix/Agmente

  • Repeat With Delay

    rebornix/Agmente

    Execute repeated shell commands as separate tool calls with a delay between each iteration.

    545 GitHub stars~473 tokensUpdated 4 mo ago
    Auto-check passed
  • Dynamically inspect ACP and Codex upstream repos using .agmente.paths, detect protocol/API/spec drift, and produce a risk-scored regression report.

    545 GitHub stars~914 tokensUpdated 4 mo ago
    Auto-check passed
  • Run Agmente Codex E2E

    rebornix/Agmente

    Run Agmente iOS end-to-end tests against a local Codex app-server endpoint, validate Codex thread/turn protocol flow, and perform mandatory cleanup.

    545 GitHub stars~464 tokensUpdated 4 mo ago
    Auto-check passed
  • Acp Local Runner

    rebornix/Agmente

    Run and debug Agmente ACP end-to-end scenarios from the repo-owned e2e/scenarios/acp specs.

    545 GitHub stars~804 tokensUpdated 4 mo ago
    Auto-check passed
  • Run Agmente E2E

    rebornix/Agmente

    Run Agmente iOS end-to-end tests against a local ACP agent (Gemini, Claude, Qwen, or Vibe), validate core RPC flow, and perform mandatory cleanup.

    545 GitHub stars~414 tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about Codex Local CLI E2E

What does Codex Local CLI E2E do?

Run and debug Agmente iOS end-to-end tests against a real local Codex CLI app-server instance. Codex Local CLI E2E is an agent skill from rebornix/Agmente. Run and debug Agmente iOS end-to-end tests against a real local Codex CLI app-server instance.

When should I use Codex Local CLI E2E?

Codex Local CLI E2E fits situations like: validating Codex websocket/protocol compatibility; connect/initialize/thread flows; reproducing Codex-only UI test failures with an actual local Codex server.

How do I install Codex Local CLI E2E in Claude Code?

Run `npx skills add rebornix/Agmente --skill codex-local-cli-e2e -a claude-code`. Or copy the skill folder (.agents/skills/codex-local-cli-e2e in rebornix/Agmente) into .claude/skills/codex-local-cli-e2e in your project. Claude Code loads it when a task matches its description.

How do I install Codex Local CLI E2E in Codex?

Run `npx skills add rebornix/Agmente --skill codex-local-cli-e2e -a codex`. Or copy the skill folder (.agents/skills/codex-local-cli-e2e in rebornix/Agmente) into .agents/skills/codex-local-cli-e2e in your project. Codex loads it when a task matches its description.

Can I use Codex Local CLI E2E in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rebornix/Agmente --skill codex-local-cli-e2e -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/codex-local-cli-e2e, .gemini/skills/codex-local-cli-e2e, .github/skills/codex-local-cli-e2e and .opencode/skills/codex-local-cli-e2e in your project.

What does Codex Local CLI E2E need to run?

Going by SKILL.md and its folder, Codex Local CLI E2E needs a shell for the scripts in its folder and the command-line tools its instructions call (codex and xcrun). Our summary lists: A Bash shell.

Does Codex Local CLI E2E access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Codex Local CLI E2E safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Codex Local CLI E2E use?

Codex Local CLI E2E is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Codex Local CLI E2E use?

About 625 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 277 tokens, read only when the agent opens those files.

What are the alternatives to Codex Local CLI E2E?

Skills that share tags, products or a category with Codex Local CLI E2E: MAUI UI Test Writer (dotnet/maui, 23k stars), iOS Testing Patterns (conorluddy/xclaude-plugin, 183 stars), iOS Audio E2E (hyochan/react-native-nitro-sound, 961 stars) and Macios Binding Creator (dotnet/macios, 2.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codex Local CLI E2E?

rebornix (a GitHub user) maintains it in rebornix/Agmente, which has 545 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on May 31, 2026.

Source: rebornix/Agmente on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.