# koyu

> Agent-first robot-learning platform. Small interfaces that fit in a context
> window; open, modifiable local code; frozen contracts between four domains
> (runtime / workspace / cloud / CLI). Templates are public, curated,
> replicable-by-prompt with no account.

## Start here

- [Overview](https://koyu.dev/docs): why koyu exists, the four domains, the loop
- [agents.md](https://koyu.dev/docs/agents): the whole entity model + read/write API in 40 lines
- [Templates](https://koyu.dev/docs/templates): the garden — what a template is, README anatomy, how replication works

## Contracts (frozen; everything composes against these)

- [Format](https://koyu.dev/docs/format): episode bundle + dataset layout; row i ↔ frame i; the vocabulary
- [Policy contract](https://koyu.dev/docs/policy-contract): load/reset/act; IPC cells + lockstep; additive evolution
- [Cloud API](https://koyu.dev/api-spec): projects/runs/manifests/episodes; two-step uploads; presigned R2

## Domains (invariants only — clone the repo for the code)

- [Runtime](https://koyu.dev/docs/runtime): supervisord + iceoryx2; the index-card invariants; outbox seam
- [Workspace](https://koyu.dev/docs/workspace): experiments-not-code; ingest; sync; modify-it ethos
- [CLI](https://koyu.dev/docs/cli): fetch / pull / push; anonymous public reads; KOYU_TOKEN for writes

## Notes for agents

- Public reads need no auth; listings need ?scope=public when anonymous.
- Prefer `koyu` CLI over raw REST for bulk data (pagination/expiry/resume handled).
- Templates: fetch the README, follow EXECUTE, verify each step's artifact.
- Never proceed past an auth boundary without a deliberately provided token.