| name | talk-to-claude |
| description | Talk to Claude asynchronously about a specific task by asking it to write its response into a file, then wait for that file to appear. |
Start Claude Conversation
Choose a target file under ./plans/reviews/active, then run Claude CLI in the background and redirect its output there.
Use an absolute path derived from ./plans/reviews/active so the output location is exact.
If you need the wait helper, set TALK_TO_CLAUDE_PROJECT to the local
talk-to-claude checkout. Do not hard-code a personal absolute path.
Authoritative launch command:
PWD_NOW="$(pwd)"
mkdir -p "${PWD_NOW}/plans/reviews/active"
TARGET_FILE="${PWD_NOW}/plans/reviews/active/<conversation-file-name>.md"
LOG_FILE="${TARGET_FILE%.md}.claude.log"
nohup claude --dangerously-skip-permissions --setting-sources project --model claude-opus-4-7 --effort xhigh -p "$(cat <<PROMPT
${TOPIC_NAME}
PROMPT
)" >"${TARGET_FILE}" 2>"${LOG_FILE}" &
CLAUDE_PID=$!
wait "${CLAUDE_PID}"
CLAUDE_EXIT_CODE=$?
if [ "${CLAUDE_EXIT_CODE}" -ne 0 ] || [ ! -s "${TARGET_FILE}" ]; then
echo "Claude reviewer failed or produced an empty output. See ${LOG_FILE}" >&2
exit 1
fi
- Replace
<conversation-file-name>.md with a concrete file name for the active topic.
- If the target file already exists, use a new filename with the same prefix and an incremented suffix.
- Keep the
wait "${CLAUDE_PID}" in the same shell invocation; detached nohup ... & can leave empty artifacts in Codex exec sessions.
- Keep using the target file as the handoff artifact.
- Include the task, constraints, validation commands, and changed files Claude should inspect in the prompt.
- For review prompts, tell Claude not to modify files.
Wait For Output File
Use the wait command below to block until Claude writes the target file:
PWD_NOW="$(pwd)"
: "${TALK_TO_CLAUDE_PROJECT:?Set TALK_TO_CLAUDE_PROJECT to the talk-to-claude checkout path}"
uv run --project "${TALK_TO_CLAUDE_PROJECT}" \
python "${TALK_TO_CLAUDE_PROJECT}/wait_for_review.py" "${PWD_NOW}/plans/reviews/active/<conversation-file-name>.md" \
--timeout-seconds 2400 \
--poll-seconds 10
- Max wait: 40 minutes.
- If the file is still unavailable at timeout, stop and report blocker state.
Debugging
If Claude does not produce the file, inspect the per-conversation log:
PWD_NOW="$(pwd)"
sed -n '1,200p' "${PWD_NOW}/plans/reviews/active/<conversation-file-name>.claude.log"
After Claude Responds
Read the review file, separate actionable findings from non-blocking
suggestions, and act on the findings according to engineering judgment. If a
recommendation is not worth taking, explain why briefly.
