bleep / For Claude Code
A Claude Code companion that approves the safe asks
bleep watches every Claude Code and Codex session on your Mac. Tests pass, lint passes, reads pass. A force push waits for you. Free and open source.
Short answer
- bleep installs hooks in Claude Code and turn notices in Codex, so it sees every session that waits on you.
- Rules in code, not a model, decide what passes. Tests, lint and reads pass. Push, deploy, delete, secrets and money always wait for you.
- Every approval is logged. You see the rest in one Agent sessions window with a short summary of each ask.
The problem
You start three Claude Code sessions and walk away. Ten minutes later, two of them sit idle, waiting for you to type yes to npm test. The third wants to git push --force, and that one really should wait for you. bleep tells these apart.
How it works
- Hooks. In setup, bleep adds a small hook to Claude Code and a notify command to Codex. You can remove them in Settings, Agents.
- Rules. Each ask is checked against
~/.bleep/agent-rules.toml. A command joined with&&,;or|passes only if every part matches and nothing risky appears anywhere in it. Shell globs always ask. - Screenshots. When an agent asks you to look at a screenshot, bleep can check it against the ask and let it continue if it matches.
- You. Anything the rules cannot read safely comes to you, with a short summary, in the chat and the Agent sessions window.
Default rules
| bleep approves | Always waits for you | |
|---|---|---|
| Commands | npm test, npx vitest run, npx playwright test, cargo test, cargo clippy, pytest, go test, ruff check, lint and type checks | git push, --force, rm, sudo, deploy commands, package installs, curl, ssh, git reset, git rebase |
| Reading | Read, Glob, Grep, git status, git diff, git log, ls, cat | Anything that touches .env, keys, tokens, .ssh, .aws, credentials or passwords |
| Other | A screenshot that matches the ask | Money, sending mail, anything outside the sandbox |
You can edit the lists. A model never turns an ask into a yes.
Compared with other Claude Code companions
| bleep | CC-Beeper | Buddi | |
|---|---|---|---|
| Alerts when a session needs you | Yes | Yes | Yes |
| Approves safe asks for you | Yes, by rules, with a log | No | You tap approve or deny |
| Codex sessions | Yes | No | No |
| Mail, calendar, reminders | Yes | No | No |
| Open source | MIT | GPL-3.0 | Yes |
Also in bleep
- Lives on your Mac. A native app with a small Rust core. A floating buddy on every Space. Double-tap
⌥to call it. - Speaks first. It checks your mail, calendar and coding agents on its own, and taps you before a meeting, when a bill is due, when a mail waits on you, or when an agent is stuck.
- Unblocks your coding agents. It approves the safe Claude Code and Codex asks your rules allow, like tests, lint and file reads. Push, deploy, delete, secrets and money always wait for you.
- Any model. Your Claude Code plan by default, an API key from Anthropic, OpenAI, Gemini, OpenRouter or Groq, or a local model in Ollama or LM Studio.
- Private. No bleep server, no account, no telemetry. Mail, memory and logs stay in
~/.bleep. - Free and open source. MIT license, source on GitHub.
Questions
How do I auto-approve safe Claude Code permission prompts on Mac?
Install bleep and let setup add its Claude Code hook. bleep then approves asks that match your rules (tests, lint, reads) and holds everything else for you. The rules live in ~/.bleep/agent-rules.toml.
Is this safer than Claude Code's own allow list?
It adds checks. bleep looks at every part of a joined command, refuses shell globs, and keeps a deny list for secrets and risky commands that wins over any allow rule. It also logs every approval.
Does bleep use my Claude plan for approvals?
No. Approvals are decided by rules in code, so they cost no model calls. Only the chat, check-ins and screenshot checks use the model.
Does it work with Codex?
Yes. bleep installs a turn notice for Codex and shows those sessions next to Claude Code.
Try bleep on your Mac
Free and open source. macOS 15+ on Apple silicon.
brew install --cask AviroopPaul/tap/bleepNo Homebrew? curl -fsSL https://bleep-omega.vercel.app/install.sh | sh · Source on GitHub