simgit worktrees

simgit is the canonical executable; sg is its equivalent alias. This skill describes safe use, but does not replace an allocator/provider hook. A capable harness must perform preflight, allocation, and cleanup, pass the cleanup token unchanged, and start the worker with its current directory set to the returned path.

Fast path

One disposable workspace for one job is the common case, and this is the whole sequence. Each step names the section that owns its rules; read that section for anything the recipe does not cover.

# 1. Discover and verify — see "Discover and verify the executable"
SIMGIT=$(command -v simgit || command -v sg) || exit 1
case "$SIMGIT" in
  /*) ;;
  */*) SIMGIT="$(cd -P "${SIMGIT%/*}" && pwd -P)/${SIMGIT##*/}" ;;
  *) echo "simgit discovery did not return an executable path" >&2; exit 1 ;;
esac
[ -f "$SIMGIT" ] && [ -x "$SIMGIT" ] || exit 1
"$SIMGIT" doctor --json     # require top-level "identity": "simgit" and "version" >= 0.4.0 — see "Preflight"