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

[RFC][PATCH 1/2] worktree: represent the primary worktree with '/' instead of NULL

From
Shreyansh Paliwal <shreyanshpaliwalcmsmn@gmail.com>
Date
Feb 13, 2026, 11:59 UTC
Message-ID
<20260213120529.15475-2-shreyanshpaliwalcmsmn@gmail.com>
In-Reply-To
<20260213120529.15475-1-shreyanshpaliwalcmsmn@gmail.com>

The worktree API uses NULL to represent the primary worktree. As a result, many callers pass NULL to implicitly refer to it, which in turn requires additional checks to ensure that `wt` is defined before use.

Represent the main worktree explicitly by setting `wt->id` to "/" in `get_main_worktree()` and update `is_main_worktree()` accordingly. Replace checks for wt to be defined in worktree.c functions with calls to `is_main_worktree()` (or strcmp(wt->id, "/")).

Signed-off-by: Shreyansh Paliwal <shreyanshpaliwalcmsmn@gmail.com>
---
 worktree.c | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)
diff --git a/worktree.c b/worktree.c
index 9308389cb6..b29934407f 100644
--- a/worktree.c
+++ b/worktree.c
@@ -101,6 +101,7 @@ static struct worktree *get_main_worktree(int skip_reading_head)
 
 	CALLOC_ARRAY(worktree, 1);
 	worktree->repo = the_repository;
+	worktree->id = xstrdup("/");
 	worktree->path = strbuf_detach(&worktree_path, NULL);
 	worktree->is_current = is_current_worktree(worktree);
 	worktree->is_bare = (is_bare_repository_cfg == 1) ||
@@ -127,6 +128,8 @@ struct worktree *get_linked_worktree(const char *id,
 
 	if (!id)
 		die("Missing linked worktree name");
+	if (!strcmp(id, "/"))
+		die("'/' is reserved for primary worktree");
 
 	repo_common_path_append(the_repository, &path, "worktrees/%s/gitdir", id);
 	if (strbuf_read_file(&worktree_path, path.buf, 0) <= 0)
@@ -206,9 +209,7 @@ struct worktree **get_worktrees_without_reading_head(void)
 
 char *get_worktree_git_dir(const struct worktree *wt)
 {
-	if (!wt)
-		return xstrdup(repo_get_git_dir(the_repository));
-	else if (!wt->id)
+	if (is_main_worktree(wt))
 		return xstrdup(repo_get_common_dir(the_repository));
 	else
 		return repo_common_path(the_repository, "worktrees/%s", wt->id);
@@ -277,7 +278,7 @@ struct worktree *find_worktree_by_path(struct worktree **list, const char *p)
 
 int is_main_worktree(const struct worktree *wt)
 {
-	return !wt->id;
+	return !strcmp(wt->id, "/");
 }
 
 const char *worktree_lock_reason(struct worktree *wt)
@@ -566,7 +567,7 @@ void strbuf_worktree_ref(const struct worktree *wt,
 {
 	if (parse_worktree_ref(refname, NULL, NULL, NULL) ==
 		    REF_WORKTREE_CURRENT &&
-	    wt && !wt->is_current) {
+	    !wt->is_current) {
 		if (is_main_worktree(wt))
 			strbuf_addstr(sb, "main-worktree/");
 		else
@@ -629,6 +630,9 @@ static void repair_gitfile(struct worktree *wt,
 	char *path = NULL;
 	int err;
 
+	if (is_main_worktree(wt))
+		goto done;
+
 	/* missing worktree can't be repaired */
 	if (!file_exists(wt->path))
 		goto done;
-- 
2.53.0
Previous: Shreyansh PaliwalNext: Junio C Hamano
Message 2 of 39 in “worktree: change representation and usage of primary worktree”
  1. Shreyansh PaliwalFeb 13, 2026
  2. [RFC][PATCH 1/2] worktree: represent the primary worktree with '/' instead of NULLShreyansh Paliwal, Feb 13, 2026
  3. Junio C HamanoFeb 13, 2026
  4. Shreyansh PaliwalFeb 14, 2026
  5. [RFC][PATCH 2/2] worktree: stop passing NULL as primary worktreeShreyansh Paliwal, Feb 13, 2026
  6. Junio C HamanoFeb 13, 2026
  7. Shreyansh PaliwalFeb 14, 2026
  8. Phillip WoodFeb 14, 2026
  9. Junio C HamanoFeb 14, 2026
  10. Shreyansh PaliwalFeb 15, 2026
  11. Phillip WoodFeb 16, 2026
  12. Junio C HamanoFeb 17, 2026
  13. Shreyansh PaliwalFeb 17, 2026
  14. 0/2 worktree_git_path(): remove repository argumentPhillip Wood, Feb 16, 2026
  15. 1/2 wt-status: avoid passing NULL worktreePhillip Wood, Feb 16, 2026
  16. Phillip WoodFeb 17, 2026
  17. Shreyansh PaliwalFeb 17, 2026
  18. Phillip WoodFeb 17, 2026
  19. Shreyansh PaliwalFeb 17, 2026
  20. Junio C HamanoFeb 17, 2026
  21. Karthik NayakFeb 17, 2026
  22. Phillip WoodFeb 18, 2026
  23. Junio C HamanoFeb 17, 2026
  24. Phillip WoodFeb 18, 2026
  25. 2/2 path: remove repository argument from worktree_git_path()Phillip Wood, Feb 16, 2026
  26. Karthik NayakFeb 17, 2026
  27. Shreyansh PaliwalFeb 17, 2026
  28. Phillip WoodFeb 17, 2026
  29. Shreyansh PaliwalFeb 17, 2026
  30. 0/2 worktree_git_path(): remove repository argumentPhillip Wood, Feb 19, 2026
  31. 1/2 wt-status: avoid passing NULL worktreePhillip Wood, Feb 19, 2026
  32. Junio C HamanoFeb 19, 2026
  33. Junio C HamanoFeb 19, 2026
  34. Phillip WoodFeb 25, 2026
  35. Junio C HamanoFeb 25, 2026
  36. Phillip WoodFeb 26, 2026
  37. Junio C HamanoFeb 26, 2026
  38. 2/2 path: remove repository argument from worktree_git_path()Phillip Wood, Feb 19, 2026
  39. Junio C HamanoFeb 19, 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.