Coming soon. Current thinking, not a shipped contract. Today a session works in its sandbox and clones a repo on demand; workspaces prepare that environment ahead of time.
- Recipe. One or more repos (each at an optional ref), a
setupstep, and an optionalwarmstep to heat caches. - Builds. Rebuilt on every push (or on an interval) into an immutable lineage; a session boots from the latest successful build and pins it.
--pool Nkeeps machines pre-booted. - Resolution. A session is not bound to a repo — it resolves which to work in from the triggering event, the conversation, an agent default, or by asking, via a
use_repotool. Resolution is lazy and re-resolvable: switch repos mid-session, or open several at once.