AgentBeeper

Phone calls for coding agents

Your agents,
on the phone.

AgentBeeper calls when Claude Code or Codex needs you, and then you talk. Ask what each open session on your laptop is doing, reply to the one that is waiting, or start a new task. Every action is read back word for word and runs only when you press 1.

npx agentbeeper setupmacOS and Linux. Node 22.13 or newer. No API keys on your laptop.
01

How it works

Your laptop watches the sessions and decides what a call may do. The call tells you what is happening and does only what you confirm.

Hooks watch every session

Setup adds command hooks to Claude Code and Codex. Each hook writes one small record to ~/.config/agentbeeper and exits, so nothing waits on the network. A local companion turns the records into one event per run, with code blocks dropped and tokens and links redacted.

Your phone rings when it matters

An agent needs input, needs permission, or finished its work. You choose which finishes ring: every one, only after the checks you approved have run, or none. The server dials only inside your rules for quiet hours, daily calls, cooldown and minutes. You can also call the number yourself, and it calls you straight back.

Ask about any agent

While the call is live, your laptop shares a board of its open sessions, with each one's project, title, state and cleaned summary. Ask which agent is waiting, what Codex finished, or what Claude is stuck on.

Act with one key

Say the reply or the task. The assistant reads it back word for word, spelling out every symbol, and your laptop runs it only after you press 1, and only in folders you opted in. On a desktop next-step box, press the key for the button you want and the session carries on.

02

Install in one command

Setup is resumable. Run it again and it skips what is already done.

  1. Run npx agentbeeper setup. Sign in in the browser page it opens, with your email or a social account, and enter the code your terminal shows. The laptop then gets its own device key; your browser session stays in the browser.
  2. Verify your phone with the SMS code and choose a six-digit PIN. The PIN protects changing the number and deleting the account, and is stored only as a salted hash.
  3. Setup finds Claude Code and Codex and installs their hooks.
  4. Take the test call. From then on, your agents can reach you.
  5. Choose where a call may act. In a project folder, run agentbeeper project add --name my-app --allow reply,start. Until you do, a call tells you what is happening and changes nothing.

You need

  • macOS or Linux
  • Node 22.13 or newer
  • Claude Code or Codex
  • A phone number in a supported country
03

Questions

What leaves my laptop?

One short event per run, with the agent, the project folder name (up to 100 characters), the kind of event, and a cleaned summary of at most 600 characters with code blocks removed and tokens and links redacted. For a desktop next-step box, the question and up to three button labels. While a call is live, the board the assistant reads, with each open session's project name, title, state and cleaned summary. Never transcripts, diffs, file contents, paths, session ids or agent output. At sign-in the laptop also sends its hostname, cut to 60 characters, as the label of its device key.

Can a call run things on my laptop?

Only where you said so. Nothing is allowed until you run agentbeeper project add in a folder and choose reply, start or both. Your laptop checks every command against that list itself, re-reading it each time, refuses everything while AgentBeeper is paused, and runs each command at most once. A start runs Claude Code or Codex in that folder with no shell and no permission bypass.

Who can hear the details?

Whoever answers your verified phone. Calls ask for no PIN. The briefing starts as soon as the call is answered, so voicemail that picks up can record it, and whoever answers can act in the folders you opted in, with the same read-back and key 1. A briefing carries only cleaned summaries, never code. Your PIN protects changing the phone number and deleting the account; five failed PIN checks in 24 hours lock those until the window passes.

Can a call approve a tool permission?

No. A call never grants a tool permission. On a voice call you can send a reply to an agent or start a task, only in folders you opted in on the laptop, and only after the call reads it back and you press 1. On a desktop next-step box, a key press chooses one of the buttons the Claude desktop app already offered, and the agent continues exactly as if you had clicked it.

Can I call it instead of waiting?

Yes. From your verified phone, call the number AgentBeeper rings you from. The call ends with a busy tone, and AgentBeeper calls you straight back with the voice assistant, which opens with the board. It only ever rings your verified phone, at most 20 callbacks a day.

How often will it call?

By default at most five calls a day with a two-minute cooldown. A call you can talk on lasts up to ten minutes, a keypad question two. Change it on the settings page or in the terminal: agentbeeper quiet 22:00-08:00 sets quiet hours, agentbeeper finish every calls on every finish, agentbeeper cap changes the daily cap and agentbeeper pause stops calls. A new event for the same run replaces the pending call instead of adding one.

What does it cost?

This deployment is self-hosted. The operator pays Twilio for calls and SMS directly; there is no subscription.

Which countries are supported?

United States, Canada, United Kingdom, Ireland, Australia, New Zealand, Germany, France, Netherlands, Belgium, Spain, Italy, Portugal, Austria, Switzerland, Sweden, Norway, Denmark, Finland, Singapore and India. Premium-rate and other non-geographic numbers are refused.