diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..fb428ad
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,4 @@
+.PHONY: test
+
+test:
+	python3 -m unittest discover -s tests -v
diff --git a/README.md b/README.md
index 638a4c6..987adbe 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,7 @@
 # Argus 👁️
 
+[![Tests](https://github.com/al-munazzim/argus/actions/workflows/tests.yml/badge.svg)](https://github.com/al-munazzim/argus/actions/workflows/tests.yml)
+
 CLI tool for GitHub/Forgejo community awareness — tracking notifications, logging activity, managing escalations.
 
 Named after **Argus Panoptes**, the all-seeing giant of Greek mythology.
@@ -54,6 +56,12 @@ For AI agents using OpenClaw, add this to your `HEARTBEAT.md` for periodic commu
 
 The install script outputs this block — just copy it to your HEARTBEAT.md.
 
+## Development
+
+```bash
+make test
+```
+
 ## Commands
 
 ### Core