Current behavior (tod 4.3.4). tod issue add-comment <ref> <content> and tod pr add-comment <ref> <content> take the comment only as an inline argument. Long Markdown – code fences, backticks, quotes, $ – breaks when it passes through a shell, and an agent has to escape it by hand. Passing - as the content posts a literal “-” comment instead of reading stdin.

Proposal. A --file <path> flag on both commands, where --file - reads stdin. The same would help --comment of issue change-state, pr discard and issue log-work.

Why. Agents post multi-paragraph reports with code blocks. Reading from a file removes the whole class of quoting failures.