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.

Updated 19 Nov 2026 · by Aviroop Paul, who makes bleep · bleep 0.5.1

Short answer

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

  1. Hooks. In setup, bleep adds a small hook to Claude Code and a notify command to Codex. You can remove them in Settings, Agents.
  2. 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.
  3. 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.
  4. 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 approvesAlways waits for you
Commandsnpm test, npx vitest run, npx playwright test, cargo test, cargo clippy, pytest, go test, ruff check, lint and type checksgit push, --force, rm, sudo, deploy commands, package installs, curl, ssh, git reset, git rebase
ReadingRead, Glob, Grep, git status, git diff, git log, ls, catAnything that touches .env, keys, tokens, .ssh, .aws, credentials or passwords
OtherA screenshot that matches the askMoney, 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

bleepCC-BeeperBuddi
Alerts when a session needs youYesYesYes
Approves safe asks for youYes, by rules, with a logNoYou tap approve or deny
Codex sessionsYesNoNo
Mail, calendar, remindersYesNoNo
Open sourceMITGPL-3.0Yes

Also in bleep

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

No Homebrew? curl -fsSL https://bleep-omega.vercel.app/install.sh | sh · Source on GitHub