discuss — Interactive markdown review session

Open markdown content in discuss, watch the user drop comments and replies, and respond with takes — the agent's view on each question or thread. Takes are semantically distinct from replies: the human types replies in the browser; the agent posts takes via the API.

The source can be either a file on disk or markdown piped in on stdin (e.g. an ad-hoc summary of a staged diff that the agent generates and pipes straight into discuss without writing to disk).

Arguments

• $ARGUMENTS — Either a path to the markdown file to review, OR markdown content the user wants to review without writing it to disk. If missing and the user has not described the content, ask which file/content and stop.

Stdin mode

When you have markdown content already in hand (e.g. a generated summary of staged changes) and don't need it on disk, pipe it in instead of writing a temp file:

• discuss - reads markdown from stdin explicitly.
• <some-command> | discuss also reads stdin (auto-detected when no file arg is given and stdin is not a TTY).

In stdin mode, the session.started event reports source_file: "<stdin>" and history archives are written under .../unnamed/ since there is no source path to derive a folder name from.