available on macOS·Apple silicon
Meet bleep, the free AI assistant for your Mac
A free, open source AI buddy for your Mac. It watches the Claude Code, Gmail and Calendar you already use, clears the small asks, and taps you only when it matters.
Free and open source (MIT). macOS 15+ on Apple silicon.
> run the tests, then fix the mobile nav
⏺ Bash(npm test)
Run the test suite
✻ Fixing the mobile nav… (esc to interrupt)
You prep 1 hour before meetings.
You pay bills the evening they're due.
Arjun likes short replies.
savedA day with bleep.
It plays on its own. Click a tab, drag bleep, or type in the chat to take over.
38 pings in.
2 reach you.
bleep reads every agent ask and every mail. It clears the safe ones, mutes the noise, and brings you only what needs you.
Needs you0
Small jobs, done on time.
Plugs into your day.
Your coding agents, Gmail, Google Calendar, Google Drive and the files on your Mac are built in. Add any app with a remote MCP server: paste its URL and sign in. If you ask for one that is off, bleep offers it in the chat.
Your stack, with a buddy on top.
Every layer is yours: your model, your tools, your Mac. bleep is the part you talk to.
Built to be trusted with your inbox.
Asks before it acts
Your rules decide. Safe asks pass. Risky ones wait for you.
Runs on your Mac
A small Rust core, light on memory and battery. Your mail and memory stay on disk. The model sees only the text it needs to answer.
Thinks with Claude
It uses the Claude Code login already on your Mac. No new API key, no extra bill.
Remembers you
Plain notes on your Mac. Read them, edit them, or tell it to forget.
Pick your buddy.
Six friends and the classic droid. Pick a color and a finish. Your menu bar icon follows along.
Buddy Tap to try
Color
Finish
I run a few Claude Code and Codex sessions at once. Half of them sat idle, waiting for me to type yes to npm test. Meanwhile a bill was due and a meeting started in ten minutes.
So I built a small buddy that watches all of it and taps me only when it matters. I use it every day.
A buddy on your Mac, not a bot farm in the cloud.
bleep is one proactive assistant that lives on your desktop. Here is how it sits next to Grok Bot, OpenClaw and OpenMausBot.
| bleep | Grok Bot | OpenClaw | OpenMausBot | |
|---|---|---|---|---|
| Main job | Watches your agents, mail and calendar, and taps you | Cloud teammates that do work in your apps | Assistant you message from chat apps | A team of agent bots, each with its own machine |
| Runs on | Your Mac, native | xAI's cloud computers | Your machine or server | Desktop app plus VMs |
| Speaks first | Yes, on its own | On tasks you set up | On schedules you set up | When you message it |
| Approves safe Claude Code and Codex asks | Yes, by your rules | No | No | No |
| Model | Claude Code plan, any API key, or local | Grok | Your choice | Claude, Codex or Grok CLIs |
| Price | Free | Paid plan | Free, pay for the model | Free |
| Open source | Yes, MIT | No | Yes | Yes |
Read more: bleep vs Grok Bot · bleep vs OpenClaw · bleep vs OpenMausBot · bleep for Claude Code · All alternatives
Questions.
How do I install it?
Run the command at the top in Terminal. Then press ⌘ Space and type bleep. A short setup connects Claude Code and Google.
What do I need?
A Mac with Apple silicon on macOS 15 or later. Intel Macs are not supported. For the model, use Claude Code (the default), an API key, or a local model in Ollama or LM Studio.
Is it free?
Yes. bleep is free and open source under the MIT license. By default it thinks with your own Claude plan through Claude Code, so its model use counts toward that plan. No API key and no extra bill.
Is bleep open source?
Yes. The full source is on GitHub under the MIT license: a Rust core built with Tauri 2 and React views. Issues and pull requests are welcome.
Can I use bleep without Claude Code?
Yes. In Settings, Model, paste an API key from Anthropic, OpenAI, Google Gemini, OpenRouter or Groq. Or pick Ollama or LM Studio to run a local model, so nothing leaves your Mac. Chat, tools and approval cards work the same way.
What data leaves my Mac?
Your mail, calendar and memory stay on your Mac. When bleep needs to think, it sends only the text it needs to Claude, through Claude Code. If you pick a local model, nothing leaves at all. There is no bleep server, no account and no telemetry.
Can it approve things in Claude Code or Codex?
Only what your rules allow. Out of the box: tests, lint, file reads, and screenshots it can check against the ask. Push, deploy, delete, secrets and money always wait for you. Every approval is logged.
Can it remind me of things?
Yes. Say "remind me at 7 to call mom" in the chat, or add one in the Reminders tab. It shows a bubble and a Mac notification on time, even in quiet hours.
Can it send email as me?
Only after you tap yes on the exact message. Sending, moving events and deleting always ask first.
Will it ping me all day?
No. Rules filter the noise first. It has quiet hours and a limit on pings per hour. Most checks end with it saying nothing.
What can it connect to?
Gmail, Google Calendar, Google Drive and the files on your Mac are built in. Turn each one on in Settings, Connectors. Add any app with a remote MCP server: paste its URL and sign in.
Can it read files on my Mac?
Only if you turn on Files on this Mac. It reads Documents, Desktop and Downloads, including the text in PDFs. It skips hidden files and keys. Before it runs any command, it shows you the exact command and waits for your yes.
Is bleep an alternative to Grok Bot?
For personal work on a Mac, yes. Grok Bot runs teams of agents on xAI's cloud computers and needs a paid plan. bleep is free, runs on your Mac, and speaks first when a meeting, a bill, a waiting mail or a stuck coding agent needs you. It does not click through other apps for you. Full comparison.
How is bleep different from OpenClaw?
OpenClaw is an assistant you message from chat apps. bleep is a native Mac app that floats on your desktop, watches your mail, calendar and coding agents on its own, and approves safe Claude Code and Codex asks by your rules. Full comparison.
Can I change how bleep looks?
Yes. Open Settings, then Avatar. Pick a buddy, a color and a finish. The menu bar icon changes to match.
How do I uninstall it?
Run brew uninstall --cask bleep, or drag bleep from Applications to the Trash. Delete ~/.bleep to remove its memory and settings.
Go do the real work.
bleep will tap you.
brew install --cask AviroopPaul/tap/bleepcurl -fsSL https://bleep-omega.vercel.app/install.sh | sh
Free and open source · Apple silicon · macOS 15+