bevy-eyes-on

name	bevy-eyes-on
description	Capture Bevy visuals with BRP state-gated scenarios first, and timed screenshots only as fallback. Use when a task needs reliable screenshots of specific game states.

Bevy Eyes-On

Use a minimal visual-check workflow for any Bevy app.

Default to BRP state-gated capture. Use timed capture only when BRP hooks are unavailable.

1) BRP State-Gated Screenshot (Primary)

bash /Users/chris/.codex/skills/bevy-eyes-on/scripts/capture_after_brp_sequence.sh \
  --requests-jsonl /path/to/scenario.jsonl \
  --brp-url http://127.0.0.1:15702 \
  --settle-ms 250 \
  --app "<AppName>"

Use for screenshots of gameplay/submenus/precise states.

scenario.jsonl is one JSON object per line:

• action call: raw BRP body, or {"body": <request>, "wait_ms": <n>}
• state probe with gate: {"probe": <request>, "until": {"path": "result.menu", "equals": "settings", "timeout_ms": 5000, "interval_ms": 100}}
• until supports exactly one matcher: equals or in.
• path uses dot lookup through objects/lists (list index by numeric segment, e.g. result.items.0.id).

Example:

{"body":{"method":"open_pause_menu","params":{}},"wait_ms":120}
{"probe":{"method":"ui_state","params":{}},"until":{"path":"result.current_menu","equals":"pause","timeout_ms":4000,"interval_ms":100}}
{"body":{"method":"open_settings","params":{}}}
{"probe":{"method":"ui_state","params":{}},"until":{"path":"result.current_menu","equals":"settings","timeout_ms":4000,"interval_ms":100}}

If BRP hooks are missing, use $bevy-brp-instrumentation.

2) Timed Screenshot (Fallback)

bash /Users/chris/.codex/skills/bevy-eyes-on/scripts/capture_after_delay.sh \
  --delay-seconds 3 \
  --app "<AppName>"

Use only for non-specific capture when state-driven BRP is unavailable.

Behavior

• Reuse a running app by default.
• Prefer state-driven BRP scenarios; do not rely on fixed sleeps for state transitions.
• Targeted capture once (--app or --window-id), then one full-display fallback.
• No loops, no heavyweight run artifacts.

Output

• Print one absolute screenshot path on success.
• Exit non-zero with a short error on failure.

Run --help on either script for full flags.