git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH 0/3] worktree: add --recurse-submodules support to git worktree add

From
PWPhillip Wood <phillip.wood123@gmail.com>
Date
Apr 16, 2026, 18:38 UTC
Message-ID
<19b86e02-6842-42f0-8226-c86ad6669ec4@gmail.com>
In-Reply-To
<xmqqzf3225u1.fsf@gitster.g>
On 16/04/2026 18:05, Junio C Hamano wrote:
Show 26 quoted lines
> Jimmy Aguilar Mena <kratsbinovish@gmail.com> writes:
> 
>> The approach follows Phillip Wood's and Junio's feedback: each linked
>> worktree gets its own per-worktree submodule gitdir under
>> $GIT_COMMON_DIR/worktrees/<id>/modules/<name>/, so HEAD, refs, and
>> the index are independent per worktree while pack files and loose
>> objects are shared via hardlinks.  The gitdir isolation is the same
>> model git worktree already uses for the superproject.
> 
> I do not quite follow.  The point of git-native worktree support
> (which improved a lot compared to its precursor, "git-new-workdir",
> is that it can work well in a hardlink-challenged platforms.  You
> shouldn't worry about "hardlinking" yourself at all.
> 
> After the superproject successfully did "submodule init", you can
> move the submodule's repository with "absorbgitdirs" to
> $GIT_DIR/modules/<submodule>/ of the superproject.  The primary
> motivation behind this feature was that you can switch to a commit
> in the superproject that does *not* have the submodule bound to it
> at all (and obviously you do not want to lose the submodule
> repository only because you tentatively switch to such a commit and
> have to re-download when you switch back), but I think it gives the
> single instance of submodule repository that you can share across
> worktrees of the submodule.  Because the single directory created
> with "absorbgitdirs" looks like a bare repository, you should be
> able to create two worktrees off of that, with their own HEAD etc.

I haven't thought much about it but that would mean that "git worktree remove" ought to remove the submodule's worktree when the worktree containing the submodule is removed. Worktrees avoid hardlinks by creating a "commondir" file in the worktree's gitdir which contains the relative path to "$GIT_COMMON_DIR". I think we could probably do the same here and create "$GIT_COMMON_DIR/worktrees/<id>/modules/<name>/commondir" containing "../../../../modules/<name>" if we want to store the submodule's gitdir under the worktree's gitdir. That way removing a worktree's gitdir removes all the gitdirs of its submodules without any extra effort. There are probably other tradeoffs between the two approaches that I've not thought of.

Thanks
Phillip
Previous: Junio C HamanoNext: Phillip Wood
Message 3 of 4 in “worktree: add --recurse-submodules support to git worktree add”
  1. 0/3 worktree: add --recurse-submodules support to git worktree addJimmy Aguilar Mena, Apr 16, 2026
  2. Junio C HamanoApr 16, 2026
  3. Phillip WoodApr 16, 2026
  4. Phillip WoodApr 17, 2026

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.