notify

Notify — Push Messages to the User

Sessions can send messages back to the user at any time. Use this when you finish something worth reporting, hit a blocker that needs input, or find something the user should know about mid-task.

Usage

# Default — auto-routes via session registry, falls back to Telegram
notify <<'WOLTSPACE_NOTIFY_7F3A91C2'
your message here
WOLTSPACE_NOTIFY_7F3A91C2

# Explicit Slack — send to a specific Slack channel + thread
notify --slack CHANNEL THREAD_TS <<'WOLTSPACE_NOTIFY_4D8E20B1'
your message here
WOLTSPACE_NOTIFY_4D8E20B1

# Explicit Telegram — send to a specific Telegram chat
notify --telegram CHAT_ID <<'WOLTSPACE_NOTIFY_A6C195E4'
your message here
WOLTSPACE_NOTIFY_A6C195E4

Use a fresh random suffix in the delimiter for every message, and quote the opening delimiter exactly as shown. Put the closing delimiter on a line by itself. Never paste the bare closing delimiter on its own line into the message body, because that would end the heredoc early. A single-quoted heredoc passes its body literally: the shell does not expand backticks, $(), variables, quotes, or other metacharacters.

notify accepts no message argument. This keeps message text out of the shell command itself on every harness.

Send a file

notify --file wolt/sparks/weekly-update.html <<'WOLTSPACE_NOTIFY_7F3A91C2'
Weekly update is ready. Open the attached page.
WOLTSPACE_NOTIFY_7F3A91C2

--file PATH sends one file to the same chat or thread the message goes to. PATH is absolute or relative to the current directory. On Telegram the file arrives as a document with your message as its caption; a message too long for a caption arrives first, and the file follows it. On Slack the file lands in the thread with your message as its comment.

Telegram reads an audio file's name. One ending in .ogg, .oga or .opus arrives as a voice note, and one ending in .mp3 or .m4a as audio in Telegram's player. If Telegram will not take it that way (an .ogg that is not Opus, say), it arrives as a plain file. Any other name is a document.