telekit send "The report is ready." --yes
telekit send "…" --file ./chart.png --yes
telekit send --file ./clip.mp4 --yes
telekit send "…" --profile alerts --yes
Never send without --yes. Without it, telekit prints the destination, the text, and each file, and does not send.

​
Files

--file is repeatable. Files go out in order, after the text (or as a caption when there is exactly one file that fits). --as-document forces a byte-exact document even for images.

​
Who receives it

On a bridged Telegram turn, telekit send without --profile uses this chat’s bot. The turn injects TELEKIT_SEND_PROFILE / TELEKIT_TURN_PROFILE so a user-configured alerts default cannot steal session replies. Outside a turn (cron, terminal, heartbeat): TELEKIT_SEND_PROFILE, then ~/.telekit/send-profile, else the default bot. Non-default profiles need --user <id> or --owner when that profile has one unambiguous owner grant. --profile <slug> selects the bot. If you set up a separate alerts bot, beats and crons should pass that profile (or set ~/.telekit/send-profile for non-turn jobs only). Telekit does not ship an alerts bot.

​
Agents

A bridged turn’s answer is your text (and outbox files) in this chat. Do not telekit send to reply. Do not add --yes unless the human asked you to message them, or a standing instruction covers it. Preview first.