@solaqua/gji 0.11.0 → 0.12.1

package/dist/worktree-picker.js

@@ -1,10 +1,26 @@
 import { env, platform, stdin, stdout } from "node:process";
 import { isCancel, Prompt } from "@clack/core";
+import { spinner } from "@clack/prompts";
 import { loadHistory } from "./history.js";
 import { createPullRequestQuery, } from "./pull-requests.js";
+import { readTask } from "./task.js";
+import { middleEllipsize, sanitizeTerminalText, startEllipsize, terminalWidth, } from "./terminal-text.js";
 import { readWorktreeInfos, } from "./worktree-info.js";
 const MAX_PULL_REQUEST_REPOSITORY_QUERY_CONCURRENCY = 4;
+const MAX_TASK_READ_CONCURRENCY = 8;
 export async function buildWorktreePromptEntries(sources, dependencies = {}) {
+    const loading = stdin.isTTY === true && stdout.isTTY === true
+        ? spinner({ indicator: "timer" })
+        : null;
+    loading?.start("Loading worktrees");
+    try {
+        return await buildWorktreePromptEntriesWithoutLoading(sources, dependencies);
+    }
+    finally {
+        loading?.stop();
+    }
+}
+async function buildWorktreePromptEntriesWithoutLoading(sources, dependencies) {
     const metadataMode = dependencies.metadata ?? "full";
     const includeMetadata = metadataMode === "full";
     const pullRequestQuery = createPullRequestQuery();
@@ -22,7 +38,7 @@ export async function buildWorktreePromptEntries(sources, dependencies = {}) {
         loadHistory(),
         includeMetadata
             ? readWorktreeInfos(sources.map((source) => source.worktree))
-            : Promise.resolve(sources.map((source) => createUnhydratedWorktreeInfo(source.worktree))),
+            : mapWithConcurrency(sources, MAX_TASK_READ_CONCURRENCY, (source) => createUnhydratedWorktreeInfo(source.worktree)),
         repositoryPullRequests,
     ]);
     const pullRequests = includeMetadata
@@ -34,11 +50,20 @@ export async function buildWorktreePromptEntries(sources, dependencies = {}) {
         .sort(comparePromptEntries)
         .map(({ lastActivityTimestamp: _lastActivityTimestamp, ...entry }) => entry);
 }
-function createUnhydratedWorktreeInfo(worktree) {
+async function createUnhydratedWorktreeInfo(worktree) {
+    let task = null;
+    try {
+        task = (await readTask(worktree.path))?.task ?? null;
+    }
+    catch {
+        // Task metadata is optional picker decoration.
+    }
     return {
         ...worktree,
         lastCommitTimestamp: null,
+        slot: null,
         status: "unknown",
+        task,
         upstream: { kind: "unknown" },
     };
 }
@@ -148,17 +173,24 @@ function buildSearchableWorktreeEntry(worktree) {
     const metadata = worktree.metadata ?? null;
     const branch = worktree.branch ?? "(detached)";
     return {
-        detail: [worktree.repoName, branch, metadata, worktree.path]
+        detail: [
+            worktree.repoName,
+            branch,
+            metadata,
+            worktree.task == null ? null : sanitizeTerminalText(worktree.task),
+            worktree.path,
+        ]
             .filter((part) => part !== null && part.length > 0)
             .join(" · "),
         label: worktree.label,
         searchText: buildPromptSearchText(worktree),
         value: worktree.path,
         worktree: {
-            branch: formatWorktreeBranchLabel(worktree.branch, worktree.pullRequestNumbers),
+            branch: formatWorktreeBranchLabel(worktree.branch, worktree.pullRequests),
             metadata,
             path: worktree.path,
             repoName: worktree.repoName,
+            task: worktree.task == null ? null : sanitizeTerminalText(worktree.task),
         },
     };
 }
@@ -488,6 +520,7 @@ class SearchablePrompt {
                 ellipsize: middleEllipsize,
                 max: 18,
                 min: 6,
+                removablePriority: entry.worktree.task === null ? undefined : 1,
                 value: entry.worktree.repoName,
             },
             {
@@ -503,13 +536,25 @@ class SearchablePrompt {
                         ellipsize: middleEllipsize,
                         max: 30,
                         min: 10,
+                        removablePriority: entry.worktree.task === null ? undefined : 0,
                         value: entry.worktree.metadata,
                     },
                 ]),
+            ...(entry.worktree.task === null
+                ? []
+                : [
+                    {
+                        ellipsize: middleEllipsize,
+                        max: 36,
+                        min: 10,
+                        value: entry.worktree.task,
+                    },
+                ]),
             {
                 ellipsize: startEllipsize,
                 max: 36,
                 min: 12,
+                removablePriority: entry.worktree.task === null ? undefined : 2,
                 value: entry.worktree.path,
             },
         ], width);
@@ -745,13 +790,25 @@ function windowPromptEntries(entries, cursor, maxItems) {
     }
     return window;
 }
+function findPromptPieceToRemove(pieces, fallbackIndex) {
+    let candidate = fallbackIndex;
+    let priority = Infinity;
+    for (let index = 0; index < pieces.length; index += 1) {
+        const piecePriority = pieces[index].removablePriority;
+        if (piecePriority !== undefined && piecePriority < priority) {
+            candidate = index;
+            priority = piecePriority;
+        }
+    }
+    return candidate;
+}
 function fitPromptPieces(pieces, width) {
     const separator = " · ";
     let visiblePieces = pieces.filter((piece) => piece.value.length > 0);
     let available = width - terminalWidth(separator) * Math.max(0, visiblePieces.length - 1);
     while (visiblePieces.length > 1 &&
         available < minimumPieceLength(visiblePieces)) {
-        const removableIndex = visiblePieces.length === 4 ? 2 : visiblePieces.length - 2;
+        const removableIndex = findPromptPieceToRemove(visiblePieces, visiblePieces.length === 4 ? 2 : visiblePieces.length - 2);
         visiblePieces = visiblePieces.filter((_, index) => index !== removableIndex);
         available =
             width - terminalWidth(separator) * Math.max(0, visiblePieces.length - 1);
@@ -819,9 +876,13 @@ function buildPromptSearchText(worktree) {
         worktree.branch ?? "detached",
         worktree.path,
         worktree.label,
+        worktree.task ?? "",
         `${worktree.repoName}/${worktree.branch ?? "detached"}`,
-        ...(worktree.pullRequestNumbers ?? []).map((number) => `#${number}`),
-        ...(worktree.pullRequestUrls ?? []),
+        ...(worktree.pullRequests ?? []).flatMap((pullRequest) => [
+            `#${pullRequest.number}`,
+            pullRequest.title ?? "",
+            pullRequest.url,
+        ]),
     ]
         .join(" ")
         .toLowerCase();
@@ -834,7 +895,7 @@ function buildWorktreePromptEntry(source, info, pullRequests, lastUsedTimestamp,
         : lastWorkedTimestamp !== null
             ? "worked"
             : null;
-    const branch = formatWorktreeBranchLabel(source.worktree.branch, pullRequests.map((pullRequest) => pullRequest.number));
+    const branch = formatWorktreeBranchLabel(source.worktree.branch, pullRequests);
     const badges = buildStatusBadges(info);
     const recency = formatPromptRecency(lastActivityTimestamp, lastActivityType, now);
     const status = badges.length > 0 ? badges.map((badge) => `[${badge}]`).join(" ") : null;
@@ -845,6 +906,9 @@ function buildWorktreePromptEntry(source, info, pullRequests, lastUsedTimestamp,
         middleEllipsize(source.repoName, 22),
         middleEllipsize(branch, 34),
         metadata,
+        info.task === null
+            ? null
+            : middleEllipsize(sanitizeTerminalText(info.task), 36),
         path,
     ]
         .filter((part) => part !== null && part.length > 0)
@@ -855,9 +919,9 @@ function buildWorktreePromptEntry(source, info, pullRequests, lastUsedTimestamp,
         label,
         lastActivityTimestamp,
         metadata,
-        pullRequestNumbers: pullRequests.map((pullRequest) => pullRequest.number),
-        pullRequestUrls: pullRequests.map((pullRequest) => pullRequest.url),
+        pullRequests,
         repoName: source.repoName,
+        task: info.task,
     };
 }
 async function readSourcePullRequests(source, queryPullRequests, pullRequestsByRepository) {
@@ -915,11 +979,18 @@ async function mapWithConcurrency(items, limit, mapper) {
 function sortSourcePullRequests(pullRequests) {
     return [...(pullRequests ?? [])].sort((a, b) => a.number - b.number);
 }
-export function formatWorktreeBranchLabel(branch, pullRequestNumbers = []) {
+export function formatWorktreeBranchLabel(branch, pullRequests = []) {
     const branchLabel = branch ?? "(detached)";
-    if (pullRequestNumbers.length === 0)
+    if (pullRequests.length === 0)
         return branchLabel;
-    return `${branchLabel} (${pullRequestNumbers.map((number) => `#${number}`).join(", ")})`;
+    return `${branchLabel} (${pullRequests
+        .map((pullRequest) => {
+        const title = pullRequest.title
+            ? ` ${middleEllipsize(sanitizeTerminalText(pullRequest.title), 48)}`
+            : "";
+        return `#${pullRequest.number}${title}`;
+    })
+        .join(", ")})`;
 }
 function buildStatusBadges(info) {
     const badges = [];
@@ -1023,72 +1094,3 @@ function scoreWorktreeMatch(entry, query) {
     }
     return buildSearchText(entry.repoName, entry).includes(query) ? 1 : null;
 }
-function middleEllipsize(value, maxLength) {
-    if (terminalWidth(value) <= maxLength) {
-        return value;
-    }
-    if (maxLength <= 1) {
-        return "…";
-    }
-    const keep = maxLength - 1;
-    const start = takeTerminalColumns(value, Math.ceil(keep / 2), "start");
-    const end = takeTerminalColumns(value, Math.floor(keep / 2), "end");
-    return `${start}…${end}`;
-}
-function startEllipsize(value, maxLength) {
-    if (terminalWidth(value) <= maxLength) {
-        return value;
-    }
-    if (maxLength <= 1) {
-        return "…";
-    }
-    return `…${takeTerminalColumns(value, maxLength - 1, "end")}`;
-}
-function takeTerminalColumns(value, maxWidth, direction) {
-    const characters = direction === "start" ? Array.from(value) : Array.from(value).reverse();
-    const kept = [];
-    let width = 0;
-    for (const character of characters) {
-        const characterWidth = terminalWidth(character);
-        if (width + characterWidth > maxWidth)
-            break;
-        kept.push(character);
-        width += characterWidth;
-    }
-    return direction === "start" ? kept.join("") : kept.reverse().join("");
-}
-function terminalWidth(value) {
-    let width = 0;
-    for (const character of Array.from(value)) {
-        width += characterTerminalWidth(character);
-    }
-    return width;
-}
-function characterTerminalWidth(character) {
-    const codePoint = character.codePointAt(0);
-    if (codePoint === undefined)
-        return 0;
-    if (isZeroWidthCodePoint(codePoint) || /\p{Mark}/u.test(character)) {
-        return 0;
-    }
-    return isWideCodePoint(codePoint) ? 2 : 1;
-}
-function isZeroWidthCodePoint(codePoint) {
-    return (codePoint === 0 ||
-        codePoint === 0x200d ||
-        (codePoint >= 0xfe00 && codePoint <= 0xfe0f));
-}
-function isWideCodePoint(codePoint) {
-    return ((codePoint >= 0x1100 && codePoint <= 0x115f) ||
-        codePoint === 0x2329 ||
-        codePoint === 0x232a ||
-        (codePoint >= 0x2e80 && codePoint <= 0xa4cf) ||
-        (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||
-        (codePoint >= 0xf900 && codePoint <= 0xfaff) ||
-        (codePoint >= 0xfe10 && codePoint <= 0xfe19) ||
-        (codePoint >= 0xfe30 && codePoint <= 0xfe6f) ||
-        (codePoint >= 0xff00 && codePoint <= 0xff60) ||
-        (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||
-        (codePoint >= 0x1f300 && codePoint <= 0x1faff) ||
-        (codePoint >= 0x20000 && codePoint <= 0x3fffd));
-}

package/dist/worktree-sources.d.ts

@@ -1,3 +1,4 @@
 import { type RepoRegistryEntry } from "./repo-registry.js";
 import type { WorktreeSource } from "./worktree-source.js";
 export declare function listRegisteredWorktreeSources(cwd: string, onSkipped?: (entry: RepoRegistryEntry) => void): Promise<WorktreeSource[]>;
+export declare function listDiscoverableWorktreeSources(cwd: string, onSkipped?: (entry: RepoRegistryEntry) => void): Promise<WorktreeSource[]>;

package/dist/worktree-sources.js

@@ -1,25 +1,30 @@
 import { detectRepository, listWorktrees } from "./repo.js";
 import { loadRegistry } from "./repo-registry.js";
+const MAX_REPOSITORY_DISCOVERY_CONCURRENCY = 4;
 export async function listRegisteredWorktreeSources(cwd, onSkipped) {
     const registry = await loadRegistry();
     const currentRoot = await detectRepository(cwd)
         .then((repository) => repository.currentRoot)
         .catch(() => null);
-    const results = await Promise.allSettled(registry.map(async (entry) => {
-        const worktrees = await listWorktrees(entry.path);
-        return { repoName: entry.name, repoRoot: entry.path, worktrees };
-    }));
+    const results = await mapWithConcurrency(registry, MAX_REPOSITORY_DISCOVERY_CONCURRENCY, async (entry) => {
+        try {
+            const worktrees = await listWorktrees(entry.path);
+            return { entry, worktrees };
+        }
+        catch {
+            onSkipped?.(entry);
+            return null;
+        }
+    });
     const allItems = [];
-    for (const [index, result] of results.entries()) {
-        if (result.status === "rejected") {
-            onSkipped?.(registry[index]);
+    for (const result of results) {
+        if (result === null)
             continue;
-        }
-        const { repoName, repoRoot, worktrees } = result.value;
+        const { entry, worktrees } = result;
         for (const worktree of worktrees) {
             allItems.push({
-                repoRoot,
-                repoName,
+                repoRoot: entry.path,
+                repoName: entry.name,
                 worktree: {
                     ...worktree,
                     isCurrent: currentRoot !== null && worktree.path === currentRoot,
@@ -29,3 +34,44 @@ export async function listRegisteredWorktreeSources(cwd, onSkipped) {
     }
     return allItems;
 }
+export async function listDiscoverableWorktreeSources(cwd, onSkipped) {
+    const currentRepository = await detectRepository(cwd).catch(() => null);
+    const registeredSources = await listRegisteredWorktreeSources(cwd, onSkipped);
+    if (currentRepository === null)
+        return dedupeSources(registeredSources);
+    let currentSources = [];
+    try {
+        currentSources = (await listWorktrees(cwd)).map((worktree) => ({
+            repoName: currentRepository.repoName,
+            repoRoot: currentRepository.repoRoot,
+            worktree,
+        }));
+    }
+    catch {
+        // Registered repositories remain discoverable when the current checkout is transiently unavailable.
+    }
+    return dedupeSources([...currentSources, ...registeredSources]);
+}
+async function mapWithConcurrency(items, limit, mapper) {
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    async function readNext() {
+        for (;;) {
+            const index = nextIndex++;
+            if (index >= items.length)
+                return;
+            results[index] = await mapper(items[index]);
+        }
+    }
+    await Promise.all(Array.from({ length: Math.min(limit, items.length) }, () => readNext()));
+    return results;
+}
+function dedupeSources(sources) {
+    const seen = new Set();
+    return sources.filter((source) => {
+        if (seen.has(source.worktree.path))
+            return false;
+        seen.add(source.worktree.path);
+        return true;
+    });
+}

package/man/man1/gji-back.1

@@ -1,4 +1,4 @@
-.TH GJI\-BACK 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-BACK 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-back \- navigate to the previously visited worktree, optionally N steps back
 .SH SYNOPSIS

package/man/man1/gji-clean.1

@@ -1,4 +1,4 @@
-.TH GJI\-CLEAN 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-CLEAN 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-clean \- interactively prune linked worktrees
 .SH SYNOPSIS

package/man/man1/gji-completion.1

@@ -1,4 +1,4 @@
-.TH GJI\-COMPLETION 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-COMPLETION 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-completion \- print shell completion definitions
 .SH SYNOPSIS

package/man/man1/gji-config.1

@@ -1,4 +1,4 @@
-.TH GJI\-CONFIG 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-CONFIG 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-config \- manage global config defaults
 .SH SYNOPSIS

package/man/man1/gji-doctor.1

@@ -1,4 +1,4 @@
-.TH GJI\-DOCTOR 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-DOCTOR 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-doctor \- check gji installation and configuration health
 .SH SYNOPSIS

package/man/man1/gji-done.1

@@ -1,4 +1,4 @@
-.TH GJI\-DONE 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-DONE 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-done \- finish the current linked worktree and return safely
 .SH SYNOPSIS

package/man/man1/gji-go.1

@@ -1,4 +1,4 @@
-.TH GJI\-GO 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-GO 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-go \- resolve and jump to a worktree path
 .SH SYNOPSIS
@@ -13,6 +13,9 @@ navigate to the main repository root
 .B \-\-print
 print the resolved worktree path explicitly
 .TP
+.B \-\-quiet
+suppress the context card
+.TP
 .B \-\-json
 emit JSON for an existing worktree destination
 .SH "SEE ALSO"

package/man/man1/gji-history.1

@@ -1,4 +1,4 @@
-.TH GJI\-HISTORY 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-HISTORY 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-history \- show navigation history
 .SH SYNOPSIS

package/man/man1/gji-init.1

@@ -1,4 +1,4 @@
-.TH GJI\-INIT 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-INIT 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-init \- set up shell integration interactively or print a shell wrapper
 .SH SYNOPSIS

package/man/man1/gji-ls.1

@@ -1,4 +1,4 @@
-.TH GJI\-LS 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-LS 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-ls \- list active worktrees
 .SH SYNOPSIS

package/man/man1/gji-new.1

@@ -1,4 +1,4 @@
-.TH GJI\-NEW 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-NEW 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-new \- create a new branch or detached linked worktree and CoW\-bootstrap configured directories
 .SH SYNOPSIS
@@ -28,6 +28,9 @@ skip refreshing the remote default branch before creating the new branch
 .B \-\-take
 move current uncommitted changes into the new worktree
 .TP
+.B \-\-task <description>
+record the purpose of the new worktree
+.TP
 .B \-\-copy
 copy current uncommitted changes instead of moving them (requires \-\-take)
 .TP

package/man/man1/gji-open.1

@@ -1,4 +1,4 @@
-.TH GJI\-OPEN 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-OPEN 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-open \- open the worktree in an editor
 .SH SYNOPSIS

package/man/man1/gji-pr.1

@@ -1,4 +1,4 @@
-.TH GJI\-PR 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-PR 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-pr \- fetch a pull request by number, #number, or URL into a linked worktree
 .SH SYNOPSIS

package/man/man1/gji-remove.1

@@ -1,4 +1,4 @@
-.TH GJI\-REMOVE 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-REMOVE 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-remove \- deprecated: use gji done for one worktree or gji clean for bulk cleanup
 .SH SYNOPSIS

package/man/man1/gji-root.1

@@ -1,4 +1,4 @@
-.TH GJI\-ROOT 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-ROOT 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-root \- print the main repository root path
 .SH SYNOPSIS

package/man/man1/gji-run-hook.1

@@ -1,4 +1,4 @@
-.TH GJI\-RUN\-HOOK 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-RUN\-HOOK 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-run\-hook \- run a named hook (after\-create, after\-enter, before\-remove) in the current worktree
 .SH SYNOPSIS

package/man/man1/gji-status.1

@@ -1,4 +1,4 @@
-.TH GJI\-STATUS 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-STATUS 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-status \- summarize repository and worktree health
 .SH SYNOPSIS

package/man/man1/gji-sync-files.1

@@ -1,4 +1,4 @@
-.TH GJI\-SYNC\-FILES 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-SYNC\-FILES 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-sync\-files \- manage local files copied into new worktrees
 .SH SYNOPSIS

package/man/man1/gji-sync.1

@@ -1,4 +1,4 @@
-.TH GJI\-SYNC 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-SYNC 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-sync \- fetch and update one or all worktrees
 .SH SYNOPSIS

package/man/man1/gji-task.1

@@ -0,0 +1,16 @@
+.TH GJI\-TASK 1 "August 2026" "gji 0.12.1" "User Commands"
+.SH NAME
+gji\-task \- show or update the current worktree task
+.SH SYNOPSIS
+.B gji task [\fIoptions\fR] [options] [task]
+.SH DESCRIPTION
+show or update the current worktree task
+.SH OPTIONS
+.TP
+.B \-\-clear
+clear the current worktree task
+.TP
+.B \-\-json
+emit task metadata as JSON
+.SH "SEE ALSO"
+.BR gji (1)

package/man/man1/gji-undo.1

@@ -1,4 +1,4 @@
-.TH GJI\-UNDO 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-UNDO 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-undo \- restore the most recent destructive worktree operation
 .SH SYNOPSIS

package/man/man1/gji-warp.1

@@ -1,4 +1,4 @@
-.TH GJI\-WARP 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI\-WARP 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji\-warp \- deprecated: use gji go (press Tab for all known repos)
 .SH SYNOPSIS

package/man/man1/gji.1

@@ -1,4 +1,4 @@
-.TH GJI 1 "July 2026" "gji 0.11.0" "User Commands"
+.TH GJI 1 "August 2026" "gji 0.12.1" "User Commands"
 .SH NAME
 gji \- Context switching without the mess.
 .SH SYNOPSIS
@@ -52,6 +52,9 @@ print the main repository root path
 .B status [options]
 summarize repository and worktree health
 .TP
+.B task [options] [task]
+show or update the current worktree task
+.TP
 .B sync [options]
 fetch and update one or all worktrees
 .TP
@@ -97,6 +100,7 @@ output the version number
 .BR gji\-go (1),
 .BR gji\-root (1),
 .BR gji\-status (1),
+.BR gji\-task (1),
 .BR gji\-sync (1),
 .BR gji\-sync\-files (1),
 .BR gji\-ls (1),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solaqua/gji",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "Git worktree CLI for fast context switching.",
   "license": "MIT",
   "author": "sjquant",

package/dist/clone-failure-store.d.ts

@@ -1,18 +0,0 @@
-export interface CloneFailureStore {
-    isCached(repoRoot: string, directory: string, scope?: string): Promise<boolean>;
-    cache(repoRoot: string, directory: string, reason: string, scope?: string): Promise<void>;
-    clear(repoRoot: string, directory: string, scope?: string): Promise<void>;
-}
-export declare class FileCloneFailureStore implements CloneFailureStore {
-    private updateQueue;
-    isCached(repoRoot: string, directory: string, scope?: string): Promise<boolean>;
-    cache(repoRoot: string, directory: string, reason: string, scope?: string): Promise<void>;
-    clear(repoRoot: string, directory: string, scope?: string): Promise<void>;
-    private update;
-    private withStateLock;
-    private readState;
-    private writeState;
-    private stateFilePath;
-}
-export declare const defaultCloneFailureStore: CloneFailureStore;
-export declare function cloneFailureScope(source: string, destination: string): Promise<string>;