what it knows
starts a run
snapshot.json
the app ZIP, once
reads
writes text back
Replace Mini-App Data
Run now
rebuild on demand, then wait
The source
API OR FEED
A bank, a watch, a weather
or a price service. Read with
your own sign-in; secrets
live in the repo.
The clock
PICK ONE
GitHub's schedule, cron-job.org,
or a Cloudflare Worker.
GitHub: your private copy
REPO
A scheduled Action runs the pull:
pull script → raw files
build → data/snapshot.json
one small JSON file the phone copies.
build-zips.yml → the app ZIP
Your AI agent
OPTIONAL, DAILY
Reads what the pull committed.
Writes evaluations or plans back
into the repo; the next build carries
them into the snapshot.
Shortcuts
ON THE PHONE
An automation fetches the file
with a read-only token and hands
it to the app. A second shortcut
starts a run and waits for it.
Snuggery
OFFLINE
The mini-app
redraws in place when the file lands.
Run now
starts the rebuild shortcut.
data hop, on a schedule
code hop, once
trigger: starts a run