ringa

Phone calls from the command line.

ringa lets an AI agent, or any script, place a phone call through your own phone. The call comes from your own number, with no Twilio, no SIP account and no per-minute bill.

$ ringa call +64211234567 --say "The deploy to production is done." --json
{"status":"answered","to":"+64211234567","phone":"mobile",
 "flow":"say","completed":true,"path":["say"],
 "ring_seconds":6,"talk_seconds":4,"calls_left":9}

One command dials, speaks your message, hangs up, prints what happened and exits.

How it works

You plug a USB Bluetooth dongle into your Mac and pair your phone with it once, the way you would pair with a hands-free car kit. From then on, ringa can ask your phone to dial.

Your own number: The call goes out from your own SIM, so the person sees a number they know.
No telephony account: There is no provider to sign up with, no SIP line to set up and no per-minute bill. Calls use your normal phone plan.
A natural voice: Your text is spoken by reo, which runs on your own machine. The audio is tuned to be clear on a phone line.
Safe in scripts: Nothing ever prompts. Every command takes --json, and the exit code says if the call was answered.

Built for AI agents

ringa is made for AI agents first, and for the developers who run them. A notification is easy to miss. A phone call is not.

Call me when the job is doneA long build, a deploy or a training run finishes while you are away from your desk, and your phone rings to tell you.
Call me when you need a decisionYour agent is stuck waiting on you. It phones, says what it needs, and you go back to it.
Send a notice from a shared phonePair a spare or company phone and let a script ring people with a short spoken message.

$ ringa contacts add me +64211234567   # save your number once
$ ringa call --say "The build finished."   # calls the default contact
$ ringa agents --install-skill          # let Claude Code know it's here

What you need

A Mac with Apple SiliconThe Mac's own Bluetooth keeps working for your keyboard and headphones.
A USB Bluetooth donglemacOS has no driver for one, so ringa drives it directly. For example, the TP-Link UB500.
Your phone, Android or iPhoneIt needs to be near the dongle when a call is placed.

Install

curl -fsSL https://ringa.wavekat.com/install.sh | sh

For macOS on Apple Silicon. ringa speaks text by running reo, so install that too:

curl -fsSL https://reo.wavekat.com/install.sh | sh

Plug in the dongle and pair your phone, once.
```
$ ringa phones pair mobile
```
The dongle shows up in your phone's Bluetooth settings as "RINGA" plus four letters and digits. Pick it, check that the 6-digit code matches, then tap Pair.
Check the setup.
```
$ ringa doctor
```

Place a call.

$ ringa call +64211234567 --say "The build finished."

What it can't do yet

Calls are one-way. ringa speaks your message and hangs up. It can't take an answer from the person, and it places calls only.

It tells you how the call went: answered, no answer or declined, how long it rang, and if the person heard the message to the end.

Free to try

Every computer gets 10 free calls. After that a dongle needs a licence, and for now a licence is free too. ringa licence shows how many calls you have left.

Questions

Do I need a Twilio or SIP account?

No. ringa uses the phone you already have. Your phone places the call over its own mobile network, so there is no telephony provider, no SIP line and no per-minute bill from anyone but your normal phone plan.

What number does the person see?

Your own. The call goes out from your phone's SIM, exactly as if you had dialled it yourself.

Does it work with iPhone and Android?

ringa pairs with a phone over Bluetooth the way a hands-free car kit does. Both iPhone and Android phones support that kind of pairing.

Can the person answer back?

No. Calls are one-way: ringa speaks your message and hangs up. It can't take an answer from the person.

Does my Mac's own Bluetooth still work?

Yes. ringa uses a separate USB Bluetooth dongle, so the Mac's built-in Bluetooth keeps working for your keyboard and headphones.

What does it cost?

Every computer gets 10 free calls. After that a dongle needs a licence, and for now a licence is free too.