Privacy

Last updated 31 August 2026

Agent Bell does not collect anything. There is no account, no analytics and no crash reporting, and nothing you type — or that an agent replies — ever leaves your Mac. The app makes exactly one request of its own, to ask whether a newer version exists, and that request is described in full below.

What stays on your Mac

Every event, and everything in it. When a turn ends, Claude Code runs a small script on your machine that posts the event to Agent Bell on 127.0.0.1 — a loopback address, which by definition cannot leave the computer. The summary is computed there. The history you see in the menu is held in memory and is gone when you quit.

What is written to disk

• A bridge script and a config file holding the loopback port and a random token, in ~/.claude/agentbell/. The config file is readable only by you.
• A debug log recording that events arrived and how they went. It records the length of what was said, never the text — your prompts and the agent's replies are not in it. It rotates at 1 MB.
• A backup of your settings.json, written before Agent Bell ever modifies it.
• Your preferences, and your licence key if you have one.

Checking for updates

Agent Bell is a downloaded app rather than an App Store one, so nothing would tell you that a new version exists unless the app asked. Once when it starts, and after that at most once every six hours, it fetches agentbell.aaronaludo.com/api/latest — a fixed address that answers with a version number and a download link. It sends nothing to get that answer: no licence key, no identifier, and nothing about your machine, your projects or your work.

What our host records is what every web server records about every visitor: the IP address the request came from, the time it arrived, and the user agent your Mac sends. There is nothing in the request that would let us connect it to a purchase or to you, and we do not try. If the request fails the app says nothing and carries on.

Licensing

A licence key is verified offline, using a signature. Your key is never sent to us — there is no activation call, no check that has to succeed before the app will run, and an outage of ours cannot switch your copy off. The update check above is a separate request that carries no key, so it cannot tell us which copy is yours. If you buy a licence, the payment is handled by our payment provider and we receive your email address in order to send you the key.

Banners

A banner is a small window Agent Bell draws itself — not a macOS notification. So the app never asks for notification permission, and nothing it shows you passes through Notification Centre or is stored there. The line you read is composed on your Mac from the event Claude Code has just handed it, and it is gone when it fades.

Questions

Write to aaronaludotech@gmail.com.