Skip to main content

Overview

Tell branches are named, immutable-history views of a workspace conversation. Use them to try an approach without mutating the selected branch, and create a recovery branch before moving a head backwards. Reset changes only a ref; it does not delete canonical history.

Example

Key Points

  • branches()->create() validates portable user branch names and inherits the current selected head unless an explicit source is provided.
  • checkout() changes the workspace default. Use TellRequest::branch() for a one-invocation selection instead.
  • reset() accepts a bounded ancestor distance and retains immutable objects; create a recovery branch first when the current head must remain named.
  • workspace()->branch() is a read-only named handle; pin() returns a TellRef fixed to the verified canonical head even after the branch advances or resets.