Skip to content

Store local data paths in local config

Forest checkout config is shared repo metadata, while local data paths are user-specific after clone. Stage schema and remote layout stay in checkout forest.yaml; stage-to-local-path bindings live in checkout local.yaml with the active remote.

Consequences

  • Cloned repos can contain enough shared forest metadata to know remotes and stages without storing user paths.
  • Commands that need local files must verify local.yaml has required stage path bindings and print exact setup commands when missing.
  • forest add PATH updates local path bindings and can add missing shared stage metadata when detection finds new stages.