available on macOSApple 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.

Star on GitHub

Free and open source (MIT). macOS 15+ on Apple silicon.

portfolio · claude

> run the tests, then fix the mobile nav

⏺ Bash(npm test)

Bash command
npm test
Run the test suite
Do you want to proceed?
❯ 1. Yes
  2. Yes, and don't ask again for npm test
  3. No, and tell Claude what to do differently
⎿ 42 passed, 0 failed (3.1s)
Approved by bleep. Tests are safe.

✻ Fixing the mobile nav… (esc to interrupt)

1
TodayThu 12 Nov
Standup10:00 AM · 15 min
Design review3:00 PM · Priya, Arjun
in 60 min
Prep ready: last 3 threads + deck
Inbox3
City PowerYour bill of ₹2,340 is due todayremind 6 PM
Arjun RaoDoes the API change ship this sprint?draft ready
FoodNowWeekend offers just for youmuted
bleep remembers

You prep 1 hour before meetings.

You pay bills the evening they're due.

Arjun likes short replies.

saved
Live demo

A day with bleep.

It plays on its own. Click a tab, drag bleep, or type in the chat to take over.

Design reviewin 60 min · Priya, Arjun
Inbox 0
Calendar
TodayThu 12 Nov
Agent sessions 4
bleep
bleep!
The filter

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.

0handled0muted

Needs you0

nothing yet
What bleep does

Small jobs, done on time.

Unblocks your coding agentsApproves the safe asks in Claude Code and Codex. Saves the risky ones for you.
Taps you before meetingsAn hour ahead, with notes on each guest.
Catches billsSpots the bill and offers a reminder. It never pays.
Answers from your mailAsk in plain words. It shows every step it takes.
Learns how you workPlain notes you can read, edit or wipe.
Reads the files on your MacLists, finds, greps and reads files and PDFs in Documents, Desktop and Downloads. A command always asks you first.
Reminds you on timeSay "remind me at 7 to call mom". A bubble and a Mac notification show up right on time.
Shows what it usesCalls, tokens and tools by day and hour. All counted on your Mac.
Offers the right connectorAsk for something a connector that is off would do. Its card and switch show up right in the chat.
Works with

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.

Claude CodeCodexGmailGoogle CalendarGoogle DriveFiles on this Mac+ any MCP app
How bleep fits together

Your stack, with a buddy on top.

Every layer is yours: your model, your tools, your Mac. bleep is the part you talk to.

Privacy and safety

Built to be trusted with your inbox.

Asks before it acts

Your rules decide. Safe asks pass. Risky ones wait for you.

approved · logged
waits for you
auto: tests · lint · reads · screenshots that match the askalways asks: push · deploy · delete · secrets · money · sending mail

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.

no bleep server~/.bleep

Thinks with Claude

It uses the Claude Code login already on your Mac. No new API key, no extra bill.

Claude Codeyour plan

Remembers you

Plain notes on your Mac. Read them, edit them, or tell it to forget.

~/.bleep/memory/USER.md
Make it yours

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

Aviroop Paul
Why I built it

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.

Aviroop
How bleep compares

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 compared with Grok Bot, OpenClaw and OpenMausBot
bleepGrok BotOpenClawOpenMausBot
Main jobWatches your agents, mail and calendar, and taps youCloud teammates that do work in your appsAssistant you message from chat appsA team of agent bots, each with its own machine
Runs onYour Mac, nativexAI's cloud computersYour machine or serverDesktop app plus VMs
Speaks firstYes, on its ownOn tasks you set upOn schedules you set upWhen you message it
Approves safe Claude Code and Codex asksYes, by your rulesNoNoNo
ModelClaude Code plan, any API key, or localGrokYour choiceClaude, Codex or Grok CLIs
PriceFreePaid planFree, pay for the modelFree
Open sourceYes, MITNoYesYes
FAQ

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/bleep

Free and open source · Apple silicon · macOS 15+

Try it: double-tap ⌥ on this page to summon bleep.