From c818c0666986834eaaa8226916b1b1268f99e895 Mon Sep 17 00:00:00 2001
From: root <root@AI.localdomain>
Date: Tue, 3 Mar 2026 07:28:18 +1100
Subject: [PATCH] docs: add cron keepalive note to avoid nested quoting

---
 README.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README.md b/README.md
index b1836a1..772de95 100644
--- a/README.md
+++ b/README.md
@@ -129,6 +129,17 @@ node src/ops/lifecycle.js status   # show running state
 node src/ops/lifecycle.js check    # health check + auto-restart if stagnant
 ```
 
+### Cron / external runner keepalive
+If you run a periodic keepalive/tick from a cron/agent runner, prefer a single simple command with minimal quoting.
+
+Recommended:
+
+```bash
+bash -lc 'node index.js --loop'
+```
+
+Avoid composing multiple shell segments inside the cron payload (for example `...; echo EXIT:$?`) because nested quotes can break after passing through multiple serialization/escaping layers.
+
 ## Public Release
 
 This repository is the public distribution.