diff --git a/Justfile b/Justfile
index 9b8b42d..f6c9546 100644
--- a/Justfile
+++ b/Justfile
@@ -21,3 +21,7 @@ watch: tools
 # Remove generated output and build caches
 clean:
     ./scripts/clean.sh
+
+# Run the CI workflow locally with act (requires act + docker)
+ci:
+    act push -W .gitea/workflows/build.yml -j build --artifact-server-path /tmp/act-artifacts
diff --git a/README.md b/README.md
index 2da37ef..259a09b 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,7 @@ checksum-verified into `tools/` on first use (no global installs, no cargo):
     just preview  # build, then serve the site locally
     just watch    # rebuild on change and serve
     just clean    # remove public/ and build caches
+    just ci       # run the CI workflow locally with act (needs act + docker)
 
 ## Adding a page