From c86e147b1afa7847b9834e5f33212e00f6bf58f8 Mon Sep 17 00:00:00 2001
From: TZGyn <spectator_brethren761@slmails.com>
Date: Fri, 11 Sep 2026 16:42:59 +0800
Subject: [PATCH] Add a formula for installing the share CLI

Lets `brew install share` pull the versioned release archive from the
share repository's Gitea releases instead of building from source.
---
 Formula/share.rb | 11 +++++++++++
 README.md        | 30 ++++++++++++++++++++++++++++--
 2 files changed, 39 insertions(+), 2 deletions(-)
 create mode 100644 Formula/share.rb

diff --git a/Formula/share.rb b/Formula/share.rb
new file mode 100644
index 0000000..23a8d33
--- /dev/null
+++ b/Formula/share.rb
@@ -0,0 +1,11 @@
+class Share < Formula
+  desc "BitTorrent-style swarm file sharing CLI with a background daemon"
+  homepage "https://gitea.tzgyn.dev/TZGyn/share"
+  url "https://gitea.tzgyn.dev/TZGyn/share/releases/download/v0.1.0/share-0.1.0-darwin-arm64.tar.gz"
+  sha256 "9e0d8d721b8ec272cc9c6f3e5b7c72dc727f8d01e0c17c20c4ff94977d1b48eb"
+  version "0.1.0"
+
+  def install
+    bin.install "share"
+  end
+end
diff --git a/README.md b/README.md
index d200e96..e6b1bca 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # TZGyn Homebrew Tap
 
-Casks for TZGyn apps. Hosted on Gitea — the full URL is required when tapping.
+Casks and command-line formulae for TZGyn apps. Hosted on Gitea — the full URL is required when tapping.
 
 ## Install
 
@@ -13,6 +13,32 @@ brew install --cask kapture
 Homebrew may print an "Unsupported tap" warning for non-GitHub taps — it's
 harmless.
 
+## Formulae
+
+### share
+
+BitTorrent-style swarm file sharing CLI. A single binary serves as the client
+(`send`/receive), the background daemon, and the relay:
+
+```bash
+brew install share
+```
+
+Seed a file into a new room (prints a room code):
+
+```bash
+share send file.txt
+```
+
+On the other machine, join that room — everyone in it both sends and receives:
+
+```bash
+share <code>
+```
+
+Releases carry macOS (Apple Silicon and Intel) and Linux builds; the formula
+currently installs the Apple Silicon build.
+
 ## Casks
 
 ### kapture
@@ -29,6 +55,6 @@ Menu bar screenshot app with on-device OCR:
 
 ## Releases
 
-Releases are published to each app's GitHub repository as zips attached to
+Releases are published to each app's Gitea repository as zips attached to
 version tags; the casks in this tap point at the latest release. Releases are
 notarized (Developer ID + stapled ticket).