diff --git a/README.md b/README.md
index 84c5d3d..44fe9cd 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,17 @@
 # taler-monitoring
 
-Standalone repository: https://git.hacktivism.ch/hernani/taler-monitoring (tag **v1.0**).
+Checks for **GNU Taler** stacks (bank, exchange, merchant; optional surface inventory).
 
-Standalone suite (formerly under host ops log). Canonical path: `~/src/taler-monitoring`.
+| Mode | What |
+|------|------|
+| **Outside-only** | Public HTTPS from anywhere — no SSH, no host-agent. Phases such as `urls`, `monpages`, `surface`, … |
+| **Inside / local** | Where you operate the stack: podman/SSH (`inside`, `versions`, `e2e`, `ladder`, …) |
+| **Host-agent + HTML** | Optional: timers run the suite and publish sticky-bar HTML under `…/monitoring/` (and surface/aptdeploy paths) |
 
-# taler-monitoring
+Outside-only example: `./taler-monitoring.sh -d demo.taler.net urls`  
+Full local GOA example: `./taler-monitoring.sh -d hacktivism.ch urls inside versions`
+
+Repo: https://git.hacktivism.ch/hernani/taler-monitoring · tree: `~/src/taler-monitoring`
 
 Host packages (koopa / runners): **[DEPENDENCIES.md](./DEPENDENCIES.md)**.  
 Host-agents (GOA + FP; shared report pipeline): **[host-agent/README.md](./host-agent/README.md)**.