# Run Agmente E2e

> 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. Use when this capability is needed.

- Skill: `tomevault-io/run-agmente-e2e` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/run-agmente-e2e`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/run-agmente-e2e/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/run-agmente-e2e

---


# Run Agmente E2E

Use this skill when the user asks to run Agmente E2E or UI-level integration checks with a real ACP agent.

## Inputs

- `agent`: `gemini` (default), `claude`, `qwen`, or `vibe`
- `scenario`: `sanity` (default), `add-server`, `prompt-send`
- `port`: default `9000`
- `simulatorID`: default `BE205EA8-B26C-44C2-B52B-B49141678273`
- `npxTag`: package tag for npx-based agents (`latest` by default). Override via third arg to `start_agent.sh` or `AGMENTE_E2E_NPX_TAG`.

## Workflow

1. Start local ACP bridge in background:
   - `./.github/skills/run-agmente-e2e/scripts/start_agent.sh <agent> <port>`
2. Build and run in simulator:
   - Use XcodeBuildMCP `build_run_sim` with Agmente defaults.
3. Execute UI steps:
   - Follow `references/ui-checklist.md`.
   - Call `describe_ui` before each tap.
   - Use tap by `id` or `label` where available.
4. Validate protocol behavior:
   - Confirm sequence: `initialize` -> `session/list` -> `session/new` -> `session/prompt`.
   - Confirm capability badges and session list behavior.
5. Cleanup always (success or failure):
   - `./.github/skills/run-agmente-e2e/scripts/cleanup.sh <simulatorID> <port>`

## Constraints

- Do not skip cleanup.
- Use a valid working directory on host machine (for Agmente server config).
- Do not rely on guessed coordinates from screenshots.
- Prefer deterministic selectors and `describe_ui`.

## References

- UI and validation checklist: `references/ui-checklist.md`

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/rebornix) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->