Reach the user on their phone through agentring — send a message, wait for their reply, or call them (a voice AI talks to them for you and returns the transcript). Use when you need the user's decision or attention and they may be away from the screen, when a long task finishes or fails, or when the user asks you to message or call them. Also use when the user asks to set up, install or connect agentring.
agentring
agentring rings and messages the user's own Android phone, over the internet (no phone
number). The tools (send_message, get_replies, call, status) come from the
agentring MCP server.
Not connected yet? If those tools are missing, or the user asks you to set agentring up, follow references/setup.md.
Pick the lightest channel
send_messagefor anything that can wait: a task finished, a summary, a question with an obvious default. Keep it short; it is read on a lock screen.get_replies(wait_s=…)after asking something: wait a few minutes (wait_s300–900) instead of polling in a loop. Each reply is returned once.callonly when it is urgent or needs a conversation: production is down, a decision blocks you and a message got no answer, or the user asked for a call. Seturgent: trueonly for real emergencies (it rings through Do Not Disturb).
Calling well
The voice AI on the call knows only what you pass:
reason: one sentence, shown on the ringing screen ("The nightly deploy failed").context: what happened, the options, your recommendation, and exactly what you need from the user. Write it for someone who has not seen your work; no ids, paths or links (they get read aloud).
call returns when the call ends. Read the transcript (and end_reason:
no_answer, hung_up, end_call, …) and act on what the user said. If nobody
answered, fall back to send_message, don't call again right away.
Don't
- Don't call for routine updates or several times in a row.
- Don't put secrets or tokens in messages or call context.
- Don't treat silence as consent: if there's no reply, keep the safe default.
- Downloads
- Security audit
- Pass
- Last updated
- 1w ago
- Current version
- v1.0.1
- License
- MIT-0
