Skip to content

Resolve local path bindings from the workspace root

In workspace mode, relative local path bindings in checkout local.yaml resolve from the workspace root, not from the checkout metadata root. This keeps data outside .forest/ while allowing each checkout's metadata to live under .forest/checkouts/<name>/; legacy repos without .forest/HEAD keep the existing config-parent behavior.

Consequences

  • Checkout commands need separate concepts for workspace root and checkout metadata root.
  • local.yaml stage path bindings use the workspace root when relative.
  • Shared checkout config stays in forest.yaml; local paths stay in local.yaml.