diff --git a/Casks/lil-agents.rb b/Casks/lil-agents.rb
new file mode 100644
index 0000000..fd8f4f0
--- /dev/null
+++ b/Casks/lil-agents.rb
@@ -0,0 +1,19 @@
+cask "lil-agents" do
+  version "1.2.2"
+  sha256 "a4cf7d9955ffb3881c6050505a9aedd91dd553952dc3e53aa00e4eb52485ea95"
+
+  url "https://github.com/ryanstephen/lil-agents/releases/download/v#{version}/LilAgents-v#{version}.zip",
+      verified: "github.com/ryanstephen/lil-agents/"
+  name "lil agents"
+  desc "Tiny AI companions that live on your macOS dock"
+  homepage "https://lilagents.xyz"
+
+  depends_on macos: ">= :sonoma"
+
+  app "lil agents.app"
+
+  zap trash: [
+    "~/Library/Preferences/xyz.lilagents.LilAgents.plist",
+    "~/Library/Caches/xyz.lilagents.LilAgents",
+  ]
+end
diff --git a/README.md b/README.md
index 7b996d8..fb8eb2b 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,19 @@ Supports **Claude Code**, **OpenAI Codex**, **GitHub Copilot**, and **Google Gem
 
 **[Download for macOS](https://lilagents.xyz)** · [Website](https://lilagents.xyz)
 
+## install
+
+### Homebrew (recommended)
+
+```bash
+brew tap ryanstephen/lil-agents
+brew install --cask lil-agents
+```
+
+### Direct download
+
+Download the latest release from [lilagents.xyz](https://lilagents.xyz).
+
 ## features
 
 - Animated characters rendered from transparent HEVC video
diff --git a/homebrew/lil-agents.rb b/homebrew/lil-agents.rb
new file mode 100644
index 0000000..fd8f4f0
--- /dev/null
+++ b/homebrew/lil-agents.rb
@@ -0,0 +1,19 @@
+cask "lil-agents" do
+  version "1.2.2"
+  sha256 "a4cf7d9955ffb3881c6050505a9aedd91dd553952dc3e53aa00e4eb52485ea95"
+
+  url "https://github.com/ryanstephen/lil-agents/releases/download/v#{version}/LilAgents-v#{version}.zip",
+      verified: "github.com/ryanstephen/lil-agents/"
+  name "lil agents"
+  desc "Tiny AI companions that live on your macOS dock"
+  homepage "https://lilagents.xyz"
+
+  depends_on macos: ">= :sonoma"
+
+  app "lil agents.app"
+
+  zap trash: [
+    "~/Library/Preferences/xyz.lilagents.LilAgents.plist",
+    "~/Library/Caches/xyz.lilagents.LilAgents",
+  ]
+end