From 1993b87d8d4f796fcde48ea44bc04d887f8724ac Mon Sep 17 00:00:00 2001
From: SimonTarara62 <33222802+SimonTarara62@users.noreply.github.com>
Date: Mon, 15 Jun 2026 21:18:24 +0300
Subject: [PATCH] ci: auto-bump Homebrew formula on release; document brew
 install
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds .github/workflows/homebrew-bump.yml — triggers on tag push (v*)
and runs dawidd6/action-homebrew-bump-formula to update capctl in the
SimonTarara62/homebrew-tap. Documents `brew install` in the README
Installation section. Cross-links distribution channels from
docs/awesome-submission.md.
---
 .github/workflows/homebrew-bump.yml | 17 +++++++++++++++++
 README.md                           |  6 ++++++
 docs/awesome-submission.md          |  4 ++++
 3 files changed, 27 insertions(+)
 create mode 100644 .github/workflows/homebrew-bump.yml

diff --git a/.github/workflows/homebrew-bump.yml b/.github/workflows/homebrew-bump.yml
new file mode 100644
index 0000000..88e764c
--- /dev/null
+++ b/.github/workflows/homebrew-bump.yml
@@ -0,0 +1,17 @@
+name: Bump Homebrew formula
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  bump:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Bump capctl in the tap
+        uses: dawidd6/action-homebrew-bump-formula@v3
+        with:
+          token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+          tap: SimonTarara62/homebrew-tap
+          formula: capctl
+          tag: ${{ github.ref_name }}
+          force: false
diff --git a/README.md b/README.md
index da94663..489df6d 100644
--- a/README.md
+++ b/README.md
@@ -80,6 +80,12 @@ Using [uv](https://docs.astral.sh/uv/) instead of pipx:
 uv tool install capitalcom-cli
 ```
 
+With [Homebrew](https://brew.sh/) (macOS/Linux):
+
+```bash
+brew install SimonTarara62/tap/capctl
+```
+
 Plain pip (into the active environment):
 
 ```bash
diff --git a/docs/awesome-submission.md b/docs/awesome-submission.md
index c005370..9954dca 100644
--- a/docs/awesome-submission.md
+++ b/docs/awesome-submission.md
@@ -28,6 +28,10 @@ entry text to submit. Keep this in sync when a submission lands.
 - **Status:** eligible; lower priority. Follow that repo's CSV row format if pursued.
 
 ## Unofficial positioning (done in this change set)
+
+Distribution channels (PyPI, Homebrew tap, Terminal Trove) are tracked in
+[distribution.md](distribution.md).
+
 "Unofficial" is now explicit in: the README title + tagline, the existing risk
 disclaimer, the `NOTICE` file, the `pyproject.toml` description (→ PyPI summary),
 the GitHub repo "About", and the `capctl --help` text.