docs(agents): note that tea reads stdin and hangs without </dev/null #62

Merged
archvillainette merged 1 commits from docs/tea-comment-stdin into main 2026-07-28 13:18:47 +00:00
Owner

tea comment reads stdin to EOF and appends whatever it finds to the comment body. In a non-interactive shell — which is every agent — stdin is an open pipe that never sends EOF, so the call hangs forever instead of posting.

Verified on tea 0.14.0: with </dev/null it posts instantly; with an open pipe it blocks until killed; with echo "x" | tea comment N "y" it posts y followed by x.

Documents the redirect in the tracker guide, and applies it to the wayfinder resolve step. Same trap exists on tea issues create --description and tea pr create.

🤖 Generated with Claude Code

`tea comment` reads stdin to EOF and appends whatever it finds to the comment body. In a non-interactive shell — which is every agent — stdin is an open pipe that never sends EOF, so the call hangs forever instead of posting. Verified on tea 0.14.0: with `</dev/null` it posts instantly; with an open pipe it blocks until killed; with `echo "x" | tea comment N "y"` it posts `y` followed by `x`. Documents the redirect in the tracker guide, and applies it to the wayfinder resolve step. Same trap exists on `tea issues create --description` and `tea pr create`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
archvillainette added 1 commit 2026-07-28 12:48:02 +00:00
tea appends stdin to the comment body, so any non-interactive shell blocks
forever waiting for EOF. Agents hit this on every tea comment call.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
archvillainette scheduled this pull request to auto merge when all checks succeed 2026-07-28 13:15:09 +00:00
xtul approved these changes 2026-07-28 13:18:45 +00:00
archvillainette merged commit cfef363107 into main 2026-07-28 13:18:47 +00:00
archvillainette deleted branch docs/tea-comment-stdin 2026-07-28 13:18:48 +00:00
Sign in to join this conversation.