| name | farfield |
| description | Use this skill when you need to verify that messages and responses appear in both: |
codex-window-debug
Use this skill when you need to verify that messages and responses appear in both:
- Codex.app UI
- Farfield web UI and server stream data
What this skill gives you
- A non-interactive window screenshot tool for Codex.app.
- A repeatable workflow to confirm cross-surface sync.
Tool path:
skills/codex-window-debug/tools/codex-window-screenshot.mjs
Quick commands
Take a screenshot of the visible Codex window:
node skills/codex-window-debug/tools/codex-window-screenshot.mjs ~/Desktop/codex-app.png
Take a screenshot and prefer a window title match:
node skills/codex-window-debug/tools/codex-window-screenshot.mjs ~/Desktop/codex-app.png --title "part of title"
Debug workflow used for message sync issues
- Check server health
curl -sS 'http://localhost:4311/api/health' | jq '.state.ipcConnected, .state.ipcInitialized, .state.lastError'
- Send a test message to a target thread
TEST_MSG="ff-sync-test $(date +%s)"
curl -sS -X POST 'http://localhost:4311/api/threads/<THREAD_ID>/messages' \
-H 'Content-Type: application/json' \
--data "{\"text\":\"$TEST_MSG\"}" | jq '.'
- Confirm stream events advanced
curl -sS 'http://localhost:4311/api/threads/<THREAD_ID>/stream-events?limit=200' | jq '.ok, (.events|length)'
- Confirm thread data contains user and agent messages
curl -sS 'http://localhost:4311/api/threads/<THREAD_ID>?includeTurns=true' | \
jq -r '.thread.turns[-2:][] | "TURN " + (.turnId // .id // "?") + " status=" + .status, (.items[] | " " + .type + ":" + ((.text // .content[0].text // "")|tostring))'
- Capture Codex.app and visually confirm same messages
node skills/codex-window-debug/tools/codex-window-screenshot.mjs ~/Desktop/codex-after.png
Notes
- The screenshot tool uses
swift + screencapture -x -l <windowId>.
- It does not use interactive selection.
- It captures the currently visible Codex window. If you need a specific thread, bring that thread to the front first.
Source: achimala/farfield — distributed by TomeVault.
