YouOS — documentation

The canonical contract is the OpenAPI spec served by every YouOS instance at GET /openapi.json. These docs explain the concepts, recipes, and runtime conventions that aren't captured by the schema alone.

For LLM-driven agents: each doc is available as rendered HTML (for humans) and raw markdown (for tool-use context). Start with Agent operations playbook.

• The Wire — newsletter digest setup · raw .md

  Turn the day's newsletters across your accounts into one Gmail-safe HTML email — every story extracted, deduped across sources, grouped by theme — then archive the originals. Preview, configure, gate, and schedule it.

• YouOS — Agent operations playbook · raw .md

  Runtime contract for LLM-driven orchestrators operating YouOS — decision tree, idempotency, error handling, paraphrasing, trust boundaries, worked end-to-end conversation. Start here if you're driving YouOS from Hermes/OpenClaw/Claude/a chat bot.

• Integrations — driving YouOS from another agent · raw .md

  Architecture diagram, setup recipe (Tailscale + token-create), endpoint reference table, security model, ~30-line Telegram bot example. The wiring side of the orchestrator vision.

• Remote access — YouOS from your phone or another machine · raw .md

  Reach YouOS from your phone via Tailscale + PIN, daily digest email, Gmail-label remote dismissal with categorical reasons (`YouOS/skip-*`), multi-account setup.

• YouOS Usage Guide · raw .md

  Every `youos ` with usage and a one-line description.

• YouOS Architecture · raw .md

  Internal module map — ingestion, retrieval, generation, agent loop, autoresearch, schema. For contributors and curious operators.

---

See also: GET /openapi.json · repo