collaborating-with-codex

name: collaborating-with-codex description: Delegates coding tasks to Codex CLI for prototyping, debugging, and code review. Use when needing algorithm implementation, bug analysis, or code quality feedback. Supports multi-turn sessions via SESSION_ID.

How to Invoke (CRITICAL)

MUST use Bash tool with run_in_background: true:

python /Users/jiabinfeng/Documents/work/go/q9jy-backend/.claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
  --cd "/Users/jiabinfeng/Documents/work/go/q9jy-backend" \
  --PROMPT "Your task description here"

After launching, use TaskOutput to get results:

TaskOutput: task_id=<returned_task_id>, block=true

Output: JSON with success, SESSION_ID, agent_messages, and optional error.

Parameters

Multi-turn Sessions

Always capture SESSION_ID from the first response for follow-up:

# Initial task
python /Users/jiabinfeng/Documents/work/go/q9jy-backend/.claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
  --cd "/Users/jiabinfeng/Documents/work/go/q9jy-backend" \
  --PROMPT "Analyze auth in backend/internal/handler/auth.go"

# Continue with SESSION_ID
python /Users/jiabinfeng/Documents/work/go/q9jy-backend/.claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
  --cd "/Users/jiabinfeng/Documents/work/go/q9jy-backend" \
  --SESSION_ID "uuid-from-response" \
  --PROMPT "Write unit tests for that"

Common Patterns

Code Review (request unified diff):

python /Users/jiabinfeng/Documents/work/go/q9jy-backend/.claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
  --cd "/Users/jiabinfeng/Documents/work/go/q9jy-backend" \
  --PROMPT "Review backend/internal/service/order.go and provide unified diff for improvements. OUTPUT: Unified Diff Patch ONLY."

Debug with full trace:

python /Users/jiabinfeng/Documents/work/go/q9jy-backend/.claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
  --cd "/Users/jiabinfeng/Documents/work/go/q9jy-backend" \
  --PROMPT "Debug this error: ..." \
  --return-all-messages