Talking to Otto
Text, voice notes in both directions, inline buttons, reactions, message edits, attachments and history.
One Telegram thread carries everything. Otto answers on the surface you used: a message typed in Claude Code is answered in the terminal, never mirrored to Telegram, because you are already reading the transcript and a copy is noise.
Text
reply sends a message to an allowlisted chat. Long messages are chunked at a
configurable limit, on newlines by default so a split never lands mid-sentence.
Markdown is opt-in per send.
Voice, both directions
Voice notes you send arrive already transcribed by a local Whisper sidecar, and the transcript is marked so Otto reads past homophones and missing punctuation instead of asking you to repeat yourself.
reply(voice: true) answers out loud through a local Qwen3-TTS sidecar. By
default the channel speaks whenever you last spoke, so a voice note gets a voice
note back with no extra thought.
Spoken replies are held to a different standard than written ones: one or two sentences, no lists, no links, no code. Those go as text. A minute of audio is a minute of your time, and synthesis runs at roughly realtime, so length is latency too. When a voice note would be too long or contains something unspeakable, the send falls back to text and says why.
The full text rides along as the voice note's caption when it fits, so the message stays readable, searchable and skimmable without a second send.
Buttons
Inline buttons, maximum six, in rows of three. A tap injects a button event
whose content is the tapped data.
Button data is written like trigger action text: a self-contained instruction a future session can execute with no other context. "Send the drafted reply to Dana", not "send it". This matters because a tap can arrive days later or after a restart, and the payload is trusted over anything the conversation appears to remember. Telegram caps callback data at 60 bytes, so anything larger is persisted and the button carries a key.
Prefer buttons to asking a question whenever the answer is one of a few known actions. An email draft gets send or discard. A reminder gets done, an hour, or tomorrow. A tapped send on a draft you have seen satisfies the draft-and-confirm rule: the tap is the approval.
Reactions and edits
react puts an emoji on one of your messages, from Telegram's fixed whitelist.
An emoji often beats a reply.
edit_message rewrites something Otto already sent. Editing pushes no
notification, which makes it the right tool for a message whose content has gone
stale rather than sending a correction as a new interruption.
Attachments
Photos, documents and voice notes you send are downloaded into a local inbox with
download_attachment. Outbound files ride along with reply, capped at 50MB,
and photos are sent as photos rather than documents so they preview.
A food photo with no question attached gets a terse macro estimate: calories plus protein, carbs and fat as ranges, one line, formatted to punch straight into a food-tracking app. No nutrition lecture.
History
read_history reads back the conversation from history.jsonl, which records
both directions with timestamps, the message id, and an attribution stamp saying
which event caused each outbound message. That stamp is what makes the
proactivity report possible.
Access
access.json holds the allowlist. Exactly one chat id is permitted, and every
tool asserts it before doing anything. Quiet hours, the voice policy, and chunking
limits live in the same file.