Keep Bot data in one external store. Then:
- Send tasks to Bots on other services. Share knowledge with them.
- Use the same Bot on other services.
Give your Bot the Bot instructions to get started. Setup, operations, and recovery guides load only when needed: INIT, OPS, RECOVERY.
Copy this prompt into the Bot you want to set up:
Clone https://github.com/transparent-pegasus/utsurigi .
Read BOT.md first, then INIT.md; follow their references to other Markdown guides.
- External data: encrypted storage and recovery, through Google Drive via the Bot's connector (default; one machine writes the hub), R2, or other stores via the Bot.
- Named hubs: choose each Bot's hub during setup.
- Live sync: tasks and rules reach the Bot's other runtimes and peers within minutes, one read per check; across machines, on R2 only. See OPS.
- Periodic review: prefer native Bot features when equivalent or better.
- Setup through dialogue.
- Required shared tasks: dependencies, user waits, goals, logs, and archived history across Bots.
- YAML configuration.
Memory RAG, Caveman. Template defaults are
Caveman on, RAG off. During setup, override an optional feature's default
to false when the Bot already covers it and the optional feature supplies no
capability missing from the Bot. An explicit user decision of true wins.
Task management is mandatory for new and existing Bots. Migrate GrokBot/Muse
records through TASKS; native schedules remain with their Bot.
Legacy tasks.enabled values are accepted for compatibility and do not disable tasks.
Choose secret delivery in this order: a secrets SaaS connector (such as 1Password),
the Bot service's Vault, then other secure host facilities. If none can be used,
an attached .env is the final fallback. See the researched
delivery options and setup procedure.
Keep credentials and repository locations recoverable after host loss. Never put
values in chat text, command arguments, logs, or YAML. The CLI reads an optional
owner-only 0600 .env beside the selected config; existing process variables win.
.env.example lists all supported input variables.
Setup passes only after restic check, a restore compared byte for byte with the
captured backup source, and verified remote retrieval when the Bot handles transfer.
Give Bots in one hub+machine the same paths.imports root. See
OPS for the cache layout, reader locks, and sync behavior.
Bundled cloud scripts: R2 only. For S3, Google Cloud Storage, etc., write your own or ask your Bot to build them through dialogue.
For trusted Bots under one owner. Requires Unix and Rust.
Validated on Linux only.
Optional memory also needs C/C++ build tools; on Debian, run apt install g++.
See optional memory for runtime and migration requirements.
Before updating an installed checkout, follow upgrading. It lists the per-version migration guides.