achimala/farfield/codex-window-debug

Claude Code and agent skill by achimala/farfield

Trust tier 2
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Install

npx vskill@latest install achimala/farfield/codex-window-debug

SKILL.md

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:

bash
node skills/codex-window-debug/tools/codex-window-screenshot.mjs ~/Desktop/codex-app.png

Take a screenshot and prefer a window title match:

bash
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

  1. Check server health
bash
curl -sS 'http://localhost:4311/api/health' | jq '.state.ipcConnected, .state.ipcInitialized, .state.lastError'
  1. Send a test message to a target thread
bash
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 '.'
  1. Confirm stream events advanced
bash
curl -sS 'http://localhost:4311/api/threads/<THREAD_ID>/stream-events?limit=200' | jq '.ok, (.events|length)'
  1. Confirm thread data contains user and agent messages
bash
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))'
  1. Capture Codex.app and visually confirm same messages
bash
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.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
217
Repository forks
32
7-day trend score
27

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 18 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/achimala/farfield/codex-window-debug/badge)](https://verified-skill.com/skills/achimala/farfield/codex-window-debug)

Something wrong with this skill or its page? Tell us.