docs: mygram tool live check

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

1 files changed, 17 insertions, 0 deletions

diff --git a/AGENTS.md b/AGENTS.md
index a9bd59f..b4f0789 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -279,6 +279,23 @@ must not decide alone (unknown host, already cloned) are asked. Spec:
 - A tool added to `~/.config/desktop-assistant/tools/` needs a daemon
   restart: `TOOLS` is loaded once at import, not per request.
 
+### Foldergram scan tool, live check (2026-10-24)
+
+`mygram` (`examples/tools/mygram.toml`): runs `sync-mygram --status`
+(`../sync-mygram`, on PATH through `~/bin`), which logs in to the LAN
+Foldergram instance and prints its scan progress: scanning or idle,
+phase, counts, last completed scan. No wrapper script; `cloud = true`
+at the user's choice.
+
+- Through `run_tool`: 1.4 s, a running rescan in its derivatives phase
+  and the last scan's new/updated/removed counts.
+- Asked by the user in a cloud chat: called and answered right.
+- Times come out UTC; the description says so.
+- It reports the scan, not when the hourly sync last ran: the script
+  keeps no run time.
+- Every call is an admin login, which Foldergram rate limits; untested
+  under repeated questions.
+
 ### Cloud models, live check (2026-10-23)
 
 Hetzner's inference API (`https://inference.hetzner.com/api/v1`,