What it makes possible.
Developers using Herdr with a hub repository whose actual application code lives in nested, separately cloned repositories.
Keep a new agent lane usable when the hub checkout itself excludes the nested application repositories.
Inside the project.
- Creates matching sub-repository worktrees when a Herdr hub lane is created.
- Reopening a lane runs the same idempotent synchronization pass.
- Uses the hub lane branch for nested repositories and leaves branches already checked out elsewhere alone.
- A manual action reports uncommitted and unpushed sub-repository work.
- Pruning acts only on paths recorded as created by this plugin; ordinary manual removal keeps uncommitted work.
Getting started.
- Herdr 0.7.5 or newer
- Git and jq
- macOS or Linux, according to the plugin manifest
- Install the plugin into Herdr.
- Create or reopen a worktree for a hub containing nested primary Git clones.
- Use the workspace status action before closing a lane.
Before you use it.
- Only nested directories with a real .git directory are detected as primary clones; nested linked worktrees are skipped.
- Herdr deletes a hub lane before firing its removal hook. The plugin cannot prevent the loss of uncommitted nested files during that close operation; the documented status action is the pre-close check.
- If a lane record is missing, cleanup skips removal until reopening recreates the record.
- Windows is not listed as a supported platform in the manifest.
Project sources.
Based on public project documentation and source, checked 7 September 2026. Refer to the repository for changes since then.