brrr CLI
A macOS CLI that installs hooks for Claude Code, Codex and Copilot CLI: a push arrives when work ends or approval is needed.
- 58 ★ on the repository
- Last commit
Extended access
Why this level
- The tool changes agent configuration and sends notification text to an external webhook.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/brrrDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The tool changes agent configuration and sends notification text to an external webhook.
This is third-party code. Review the repository files before installing.
What it does
The `brrr` tool wires webhook notifications through the brrr.now service into agent CLIs. When Claude, Codex or Copilot finishes, or Claude waits for approval or an answer, a push lands on your iPhone or iPad. Each agent has its own icon so notifications are distinguishable at a glance. `brrr agent install all --webhook ... --idle-seconds 300` edits `~/.claude/settings.json`, `hooks.json` in the Codex directory and `.github/hooks/brrr-copilot.json` in the repository for Copilot. Hooks use `Stop`, `PermissionRequest` and other agent events. If Copilot is not installed its hook is skipped without an error. `brrr agent status` and `brrr agent uninstall` show state and remove only brrr-managed hooks.
Who it is for. macOS developers who start long tasks in Claude Code, Codex or Copilot CLI and step away from the computer.
Good fit when
- An agent works for a long time and you want to know when it finishes without watching the screen.
- Claude waits for an access approval while you are away from the keyboard.
- One notification channel must serve several agents with different icons.
- The webhook URL lives in an environment variable rather than in the command: the option accepts `$BRRR_WEBHOOK_URL`.
Not a fit when
- You need Linux or Windows: the tool is built for macOS.
- Agent reply text cannot go to an external service.
- You have no brrr.now account and webhook.
Example request
Install brrr for all agents with my webhook and a 300-second idle timeout.Limitations
It runs on macOS and installs through Homebrew. It needs a webhook like `https://api.brrr.now/v1/br_...` from a brrr.now account and accepts no other URLs. Installation changes agent configuration, so back up `~/.claude/settings.json` and Codex `hooks.json` first. The Copilot hook is written into the repository and applies only where the command ran. On completion Copilot sends its latest reply when it can be recovered. The notification text goes to the brrr.now service, so avoid it for confidential projects.
How to disable. Run `brrr agent uninstall all`: it removes only brrr hooks. Then remove the package with `brew uninstall brrr`.
FAQ
How do I install it?
Run `brew tap simonbs/brrr-cli https://github.com/simonbs/brrr-cli.git`, `brew trust simonbs/brrr-cli` and `brew install brrr`.
How do I connect the agents?
Run `brrr agent install all --webhook <url> --idle-seconds 300`. Replace `all` with a name for a single agent.
How do I keep the webhook in a variable?
Pass `$BRRR_WEBHOOK_URL` in single quotes so the shell does not expand it too early. The value is read when the hook fires.
Where is the Copilot hook?
In `.github/hooks/brrr-copilot.json` of the current repository. Run the Copilot command from the repository directory.
How do I check and remove it?
`brrr agent status` shows installed integrations and their files and `brrr agent uninstall` removes brrr hooks.
Discussion
No questions or reviews yet.
Related
CLI toolsCode-Notify sends a desktop notification when Claude Code, Codex or Gemini CLI finishes a task or waits for your input
Claude Code hooks for macOS: a notification returns you to the original terminal window, and a push reaches your phone when idle.
echook plays a sound, a desktop toast or a message when Claude Code, Cursor or Codex finishes or waits for your permission
Hook-driven sounds for coding agents: starts, failures, completions and even individual Bash commands each get their own cue
Voice control of Claude Code and Codex sessions on your machines: a small agent on each box links it to the pitupitu cloud.
Local voice layer for Claude Code and Codex on macOS: when the agent finishes or fails, it says in a sentence or two what happened
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| brrr (this card) | no | 58 | |
| cc-notifier | no | 112 | notification hooks for Claude Code on macOS only; brrr covers Claude Code, Codex and Copilot through a webhook |
| Agent Notifications | no | 831 | a plugin showing project and branch in messages; brrr sends pushes to iPhone through a webhook |
README in short
The tool uses Claude, Codex and Copilot hooks to catch completion and sends a request to the webhook. The README has a table of supported agents, their config files and events.