Homebrew tap: auto-bump workflow + install docs

.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

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

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.