Skip to content
transparent-pegasusPublic

Repository files navigation

utsurigi

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.

First prompt for your Bot

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.

Features

  • 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.

Optional features

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.

Credentials and recovery

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.

Requirements

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.

Upgrading

Before updating an installed checkout, follow upgrading. It lists the per-version migration guides.

Releases

Packages

Contributors

Languages