From b12830fc698133275c6892ca3221da4ef7e0aee0 Mon Sep 17 00:00:00 2001
From: "tembo[bot]" <208362400+tembo[bot]@users.noreply.github.com>
Date: Mon, 6 Jul 2026 15:23:58 +0000
Subject: [PATCH] docs(agents): document Homebrew formula update workflow

---
 AGENTS.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index fc9d799..cb1a59f 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -50,6 +50,16 @@ Major versions need migration notes in the PR that introduces the breaking chang
 
 Do not merge a `Version packages` PR for a major version unless the migration path is documented.
 
+## Homebrew Formula
+
+The Homebrew formula lives at `Formula/email-sdk.rb` and tracks the latest published npm release. To regenerate its `url` and `sha256` from the published tarball:
+
+```bash
+bun run homebrew:update
+```
+
+This runs automatically after a publish: `.github/workflows/release.yml` runs `homebrew:update` and, if the formula changed, opens an `automation/homebrew-formula-<version>` PR. Merge that PR to point Homebrew at the new release.
+
 ## CI and Publishing
 
 - Depot CI lives in `.depot/workflows/ci.yml`.