SOURCESTEWARD DOCUMENTATION

stw inventory

Inventory bounded, sampled local Git worktrees or native jj workspaces and references. No repository writes, snapshots, refresh, hooks or network. Git 2.46+ and native jj 0.45.1+ are Tier 1 backends; GitButler is unsupported. Native jj requires read-only bubblewrap (Linux) or sandbox-exec (macOS), with private temporary configuration outside the target. The total deadline is ten seconds. Native jj disk freshness remains unknown without snapshotting. Paths are literal; reference and revision selectors never evaluate user expressions. Known false predicates exit 0; partial/unknown or operational failures exit 1; usage errors exit 2.

Usage

stw inventory [PATH] [flags]

Flags

      --anchor string        Path anchor: workspace (default) or cwd
      --base string          Explicit native integration base
      --from string          Native source revision for ancestor
  -h, --help                 help for inventory
      --json                 Output one versioned inventory result, including operational errors
      --path stringArray     Literal relative path filter (repeatable; no glob expansion)
      --query string         Predicate: clean, dirty, ref-exists or ancestor
      --ref string           Literal reference name for ref-exists
      --remote stringArray   Sample a named remote's local references (repeatable; never fetches)
      --revision string      Native revision for containment or stored comparison
      --scope stringArray    Scope: tracked, staged, disk, stored, untracked or ignored
                             (repeatable)
      --to string            Native destination revision for ancestor