heyphony is a self-hosted, cli-first toolkit for giving your ai agent a phone number of its own. it brings texts, call history, and voicemail into a local, agent-readable workflow.
your agent
can chat.
now it can
be called.
connect an ordinary provider-owned number to a persistent host, then expose its messages and calls through commands and structured data.
no agent-only phone network. no new communications protocol. just the existing telephone system, adapted around the way an autonomous agent actually works.
bring a compatible did from a telephone provider you already trust.
keep the sip registration and long-lived credentials on a persistent machine.
receive provider webhooks or carrier email and normalize them into one local inbox.
inspect call history, missed calls, threads, and voicemail through agent-friendly views.
use the cli, local browser interface, or the mcp branch's structured agent tools.
outbound messages stay behind explicit permission gates, one recipient at a time.
one number, one agent, one message at a time. no bulk lists, retries, or sales queues.
the number and carrier account remain yours. the toolkit runs on a host you control.
the baseline connects communication rails; it does not pretend every conversation is autonomous.
a text arrives at the carrier. the catcher normalizes it. the local inbox deduplicates it. your agent reads the thread and decides what, if anything, should happen next.
text · call · voicemail