diff --git a/CLAUDE.md b/CLAUDE.md
index 65cc591..086ff07 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -50,25 +50,18 @@ Default port: `8090` (maps to internal `8080`).
 
 ## homelab-dashboard integration
 
-The dashboard depends on corvid as an editable pip install:
+The dashboard depends on corvid via Forgejo:
 
-```bash
-# Local dev
-pip install -e ~/Projects/corvid
-
-# VPS deploy — corvid is rsynced alongside the dashboard, then installed
-rsync -az ~/Projects/corvid/ root@157.180.29.73:/opt/corvid/
-ssh root@157.180.29.73 'pip install -e /opt/corvid'
+```
+# requirements.txt
+corvid @ git+https://forgejo.welvaert.org/caoimhinr/corvid.git@main
 ```
 
-The dashboard's `Dockerfile` copies corvid source before installing:
+Local dev: `pip install -e ~/Projects/corvid`
 
-```dockerfile
-COPY ../corvid/ /tmp/corvid/      # requires parent-dir build context
-RUN pip install --no-cache-dir /tmp/corvid/
-```
-
-See `homelab-dashboard/CLAUDE.md` for the full deploy procedure.
+**Push corvid to Forgejo before rebuilding the dashboard image** — the Docker
+build pulls `@main` at build time. See `homelab-dashboard/CLAUDE.md` for the
+full deploy procedure.
 
 ## Local dev