diff --git a/README.md b/README.md
index 09c7274..f54f9f5 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,36 @@
 # claude-desktop-package
 
-Repackages Claude Desktop into signed RPMs for Fedora, published to rpm.lair.cafe
\ No newline at end of file
+Repackages [Claude Desktop](https://claude.ai) into signed RPMs for Fedora 43 & 44
+and publishes them to the self-hosted dnf repo at `rpm.lair.cafe`.
+
+Claude Desktop's in-app updater is macOS/Windows-only (Electron native
+`autoUpdater`), so on Linux it never self-updates. Anthropic ships a Debian/apt
+repo but no dnf repo; this repo is the Fedora equivalent, tracking upstream and
+rebuilding automatically.
+
+## How it works
+
+- **poll-upstream** — every 6h, reads Anthropic's apt `Packages` index for the
+  latest version and dispatches a build if `rpm.lair.cafe` doesn't already have it.
+- **build-release** — downloads and checksum-verifies the upstream `.deb`,
+  repackages the prebuilt Electron bundle as an RPM (`rpm/claude-desktop.spec`),
+  signs it, and publishes to fc43 + fc44 trees.
+
+No app source lives here — only packaging. See `CLAUDE.md` for details.
+
+## Install (Fedora)
+
+```bash
+sudo tee /etc/yum.repos.d/lair.repo <<'EOF'
+[lair]
+name=lair
+baseurl=https://rpm.lair.cafe/fedora/$releasever/x86_64/
+enabled=1
+gpgcheck=1
+gpgkey=https://rpm.lair.cafe/RPM-GPG-KEY-lair
+EOF
+sudo dnf install claude-desktop
+```
+
+(Use the same `.repo`/GPG-key convention as the other `lair` packages if one
+already exists on your hosts.)