corail: instructions for an agent writing a manifest Vocabulary capsule one container atoll a group of capsules that share one network namespace (a pod) reef.json the file that describes an atoll corail the engine coraild the control plane recify the client sonar the terminal UI Rules 1. One root. A reef.json describes exactly one atoll. It has a name and at least one capsule. 2. Rootless. Do not ask for root. net defaults to "none". "bridge" and publish need root; leave them out. 3. Names: atoll, capsule and volume names use only a-z A-Z 0-9 - _ . and are unique in their list. 4. Capsules of one atoll reach each other over 127.0.0.1. 5. Init capsules run first; their names must differ from capsule names. 6. A volume needs host_path or files. A volume_mount needs a declared volume and an absolute mount_path. 7. A probe needs exec, tcp or http_port, and period_seconds above 0. 8. recify apply prints the reason when a rule is broken. Fix the file; do not retry unchanged. Atoll fields name (required) namespace="default" restart=Always|Never|OnFailure (default Always) net=none|host|bridge (default none) publish=["host:capsule"] (bridge only) termination_grace_period_seconds=5 volumes=[] init_capsules=[] capsules=[] (required) Capsule fields name (required) image (required) cmd=[] env=["K=V"] secret_env=["K=V"] liveness|probe|readiness|startup = Probe volume_mounts=[{name, mount_path, read_only}] resources={memory, cpus, pids} Probe fields exec=[cmd...] | tcp=port | http_port=port + http_path="/" period_seconds=10 failure_threshold=3 initial_delay_seconds=0 Volume fields name, host_path, files=[{path, content}] Minimal manifest {"name":"web","capsules":[{"name":"app","image":"alpine:latest","cmd":["sleep","300"]}]} Apply and check recify apply -f reef.json recify get atolls Full field reference: /docs/atoll Exact CLI text: /docs/usage