Integrate brrr with Copilot

GitHub Copilot CLI supports hooks, which run shell commands at key points during agent execution. That makes Copilot a good fit for brrr.

The easiest route is brrr-cli, which installs a repo-local Copilot hooks file for you and sends pushes when Copilot finishes working or hits an error.

Use brrr-cli

Run the install command from the repository where you use Copilot CLI. Copilot loads hooks from the current working directory, so brrr-cli writes its configuration to .github/hooks/brrr-copilot.json in that repository.

brew tap simonbs/brrr-cli https://github.com/simonbs/brrr-cli.git
brew install brrr

brrr agent install copilot --webhook '$BRRR_WEBHOOK_URL' --idle-seconds 300

If you prefer, you can also pass the full webhook URL directly instead of using an environment variable. Using single quotes around $BRRR_WEBHOOK_URL ensures your shell does not expand it during installation.

--idle-seconds 300 is a good default if you mainly want pushes when you step away from your Mac. Use 0 if you want the notification immediately when Copilot finishes.

Check installation status

You can confirm whether Copilot is present, whether brrr has installed its hook, and which config file is in use with:

brrr agent status

If you no longer want the integration, remove only the brrr-managed hook with brrr agent uninstall copilot.

What brrr-cli installs

brrr-cli installs a portable Copilot hook file that calls brrr from PATH. If another contributor opens the same repository without brrr installed, the hook exits successfully without doing anything.

For turn-end notifications, brrr-cli includes the latest Copilot reply when it can recover it and falls back to a simpler “Copilot finished working” message when it cannot.

Learn more in the brrr-cli repository and the official Copilot hooks documentation.