@solaqua/gji 0.6.1 → 0.7.0

package/dist/warp.js

@@ -1,18 +1,20 @@
-import { isCancel, select } from '@clack/prompts';
-import { readWorktreeHealth } from './git.js';
-import { isHeadless } from './headless.js';
-import { appendHistory } from './history.js';
-import { runNewCommand } from './new.js';
-import { loadRegistry } from './repo-registry.js';
-import { listWorktrees } from './repo.js';
-import { writeShellOutput } from './shell-handoff.js';
-const WARP_OUTPUT_FILE_ENV = 'GJI_WARP_OUTPUT_FILE';
+import { realpath } from "node:fs/promises";
+import { basename, resolve } from "node:path";
+import { isCancel, select } from "@clack/prompts";
+import { readWorktreeHealth } from "./git.js";
+import { isHeadless } from "./headless.js";
+import { appendHistory } from "./history.js";
+import { runNewCommand } from "./new.js";
+import { listWorktrees } from "./repo.js";
+import { loadRegistry } from "./repo-registry.js";
+import { writeShellOutput } from "./shell-handoff.js";
+const WARP_OUTPUT_FILE_ENV = "GJI_WARP_OUTPUT_FILE";
 export async function runWarpCommand(options) {
     if (options.newWorktree) {
         const registry = await loadRegistry();
         if (registry.length === 0) {
-            options.stderr('gji warp: no repos registered yet.\n' +
-                'Use any gji command in a repository to register it automatically.\n');
+            options.stderr("gji warp: no repos registered yet.\n" +
+                "Use any gji command in a repository to register it automatically.\n");
             return 1;
         }
         return runWarpNew(options, registry);
@@ -21,16 +23,20 @@ export async function runWarpCommand(options) {
 }
 async function runWarpNavigate(options) {
     if ((isHeadless() || options.json) && !options.branch) {
-        const message = 'branch argument is required';
+        const message = "branch argument is required";
         if (options.json) {
             options.stderr(`${JSON.stringify({ error: message }, null, 2)}\n`);
         }
         else {
-            options.stderr('gji warp: branch argument is required in non-interactive mode (GJI_NO_TUI=1)\n');
+            options.stderr("gji warp: branch argument is required in non-interactive mode (GJI_NO_TUI=1)\n");
         }
         return 1;
     }
-    const target = await resolveWarpTarget({ ...options, commandName: 'gji warp', json: options.json });
+    const target = await resolveWarpTarget({
+        ...options,
+        commandName: "gji warp",
+        json: options.json,
+    });
     if (!target)
         return 1;
     if (options.json) {
@@ -43,25 +49,26 @@ async function runWarpNavigate(options) {
     return 0;
 }
 async function runWarpNew(options, registry) {
+    const deduplicatedRegistry = await deduplicateRegistryForNew(registry);
     let targetRepoRoot;
-    if (registry.length === 1) {
-        targetRepoRoot = registry[0].path;
+    if (deduplicatedRegistry.length === 1) {
+        targetRepoRoot = deduplicatedRegistry[0].path;
     }
     else {
         if (isHeadless()) {
-            options.stderr('gji warp: repo argument is required in non-interactive mode (GJI_NO_TUI=1)\n');
+            options.stderr("gji warp: repo argument is required in non-interactive mode (GJI_NO_TUI=1)\n");
             return 1;
         }
         const choice = await select({
-            message: 'Create worktree in which repo?',
-            options: registry.map((entry) => ({
+            message: "Create worktree in which repo?",
+            options: deduplicatedRegistry.map((entry) => ({
                 value: entry.path,
                 label: entry.name,
                 hint: entry.path,
             })),
         });
         if (isCancel(choice)) {
-            options.stderr('Aborted\n');
+            options.stderr("Aborted\n");
             return 1;
         }
         targetRepoRoot = choice;
@@ -78,7 +85,7 @@ async function runWarpNew(options, registry) {
     // runNewCommand writes the created path to options.stdout via writeShellOutput.
     // Since GJI_NEW_OUTPUT_FILE is not set in the warp shell context, it falls
     // through to our captured stdout, giving us the path to hand off.
-    let capturedPath = '';
+    let capturedPath = "";
     const captureStdout = (chunk) => {
         capturedPath = chunk.trim();
     };
@@ -92,14 +99,39 @@ async function runWarpNew(options, registry) {
         return exitCode;
     }
     if (!capturedPath) {
-        options.stderr('gji warp: could not determine new worktree path\n');
+        options.stderr("gji warp: could not determine new worktree path\n");
         return 1;
     }
     await writeShellOutput(WARP_OUTPUT_FILE_ENV, capturedPath, options.stdout);
     return 0;
 }
+async function deduplicateRegistryForNew(registry) {
+    const deduplicated = [];
+    const seenPaths = new Set();
+    for (const entry of registry) {
+        const canonicalPath = await canonicalizeRepoPath(entry.path);
+        if (seenPaths.has(canonicalPath)) {
+            continue;
+        }
+        seenPaths.add(canonicalPath);
+        deduplicated.push({
+            ...entry,
+            name: basename(canonicalPath),
+            path: canonicalPath,
+        });
+    }
+    return deduplicated;
+}
+async function canonicalizeRepoPath(repoPath) {
+    try {
+        return await realpath(repoPath);
+    }
+    catch {
+        return resolve(repoPath);
+    }
+}
 function findByQuery(items, query) {
-    const slashIdx = query.indexOf('/');
+    const slashIdx = query.indexOf("/");
     if (slashIdx !== -1) {
         const repoQuery = query.slice(0, slashIdx);
         const branchQuery = query.slice(slashIdx + 1);
@@ -110,7 +142,7 @@ function findByQuery(items, query) {
     return items.find((item) => item.worktree.branch === query) ?? null;
 }
 export async function resolveWarpTarget(options) {
-    const cmd = options.commandName ?? 'gji';
+    const cmd = options.commandName ?? "gji";
     const emitError = (message, hint) => {
         if (options.json) {
             options.stderr(`${JSON.stringify({ error: message }, null, 2)}\n`);
@@ -123,7 +155,7 @@ export async function resolveWarpTarget(options) {
     };
     const registry = await loadRegistry();
     if (registry.length === 0) {
-        emitError('not in a git repository and no repos registered yet.', 'Use any gji command inside a repository to register it.\n');
+        emitError("not in a git repository and no repos registered yet.", "Use any gji command inside a repository to register it.\n");
         return null;
     }
     const results = await Promise.allSettled(registry.map(async (entry) => {
@@ -132,7 +164,7 @@ export async function resolveWarpTarget(options) {
     }));
     const allItems = [];
     for (const result of results) {
-        if (result.status === 'rejected')
+        if (result.status === "rejected")
             continue;
         const { repoName, worktrees } = result.value;
         for (const worktree of worktrees) {
@@ -140,7 +172,7 @@ export async function resolveWarpTarget(options) {
         }
     }
     if (allItems.length === 0) {
-        emitError('no accessible worktrees found in any registered repo.');
+        emitError("no accessible worktrees found in any registered repo.");
         return null;
     }
     if (options.branch) {
@@ -153,7 +185,7 @@ export async function resolveWarpTarget(options) {
     }
     const path = await promptForWarpTarget(allItems);
     if (!path) {
-        options.stderr('Aborted\n');
+        options.stderr("Aborted\n");
         return null;
     }
     const chosen = allItems.find((item) => item.worktree.path === path);
@@ -162,11 +194,11 @@ export async function resolveWarpTarget(options) {
 async function promptForWarpTarget(items) {
     const healthResults = await Promise.allSettled(items.map((item) => readWorktreeHealth(item.worktree.path)));
     const choice = await select({
-        message: 'Warp to a worktree',
+        message: "Warp to a worktree",
         options: items.map((item, i) => {
-            const health = healthResults[i].status === 'fulfilled' ? healthResults[i].value : null;
+            const health = healthResults[i].status === "fulfilled" ? healthResults[i].value : null;
             const upstream = health ? formatHint(item.worktree.branch, health) : null;
-            const label = `${item.repoName} › ${item.worktree.branch ?? '(detached)'}`;
+            const label = `${item.repoName} › ${item.worktree.branch ?? "(detached)"}`;
             const pathHint = item.worktree.isCurrent
                 ? `${item.worktree.path} (current)`
                 : item.worktree.path;
@@ -183,11 +215,11 @@ function formatHint(branch, health) {
     if (branch === null)
         return null;
     if (!health.hasUpstream)
-        return 'no upstream';
+        return "no upstream";
     if (health.upstreamGone)
-        return 'upstream gone';
+        return "upstream gone";
     if (health.ahead === 0 && health.behind === 0)
-        return 'up to date';
+        return "up to date";
     if (health.ahead === 0)
         return `behind ${health.behind}`;
     if (health.behind === 0)

package/dist/worktree-info.d.ts

@@ -1,29 +1,29 @@
-import { type WorktreeHealth } from './git.js';
-import type { WorktreeEntry } from './repo.js';
+import { type WorktreeHealth } from "./git.js";
+import type { WorktreeEntry } from "./repo.js";
 export interface WorktreeInfo extends WorktreeEntry {
     lastCommitTimestamp: number | null;
-    status: WorktreeHealth['status'] | 'unknown';
+    status: WorktreeHealth["status"] | "unknown";
     upstream: UpstreamState;
 }
 export interface SerializedWorktreeInfo {
     branch: string | null;
     lastCommitTimestamp: number | null;
     path: string;
-    status: WorktreeInfo['status'];
+    status: WorktreeInfo["status"];
     upstream: UpstreamState;
 }
 export type UpstreamState = {
-    kind: 'detached';
+    kind: "detached";
 } | {
-    kind: 'no-upstream';
+    kind: "no-upstream";
 } | {
-    kind: 'stale';
+    kind: "stale";
 } | {
-    kind: 'tracked';
+    kind: "tracked";
     ahead: number;
     behind: number;
 } | {
-    kind: 'unknown';
+    kind: "unknown";
 };
 export declare function readWorktreeInfos(worktrees: WorktreeEntry[]): Promise<WorktreeInfo[]>;
 export declare function serializeWorktreeInfo(info: WorktreeInfo): SerializedWorktreeInfo;

package/dist/worktree-info.js

@@ -1,40 +1,40 @@
-import { readBranchLastCommitTimestamp, readWorktreeHealth } from './git.js';
+import { readBranchLastCommitTimestamp, readWorktreeHealth, } from "./git.js";
 export async function readWorktreeInfos(worktrees) {
     return Promise.all(worktrees.map((worktree) => readWorktreeInfo(worktree)));
 }
 async function readWorktreeInfo(worktree) {
     const [healthResult, lastCommitResult] = await Promise.allSettled([
         readWorktreeHealth(worktree.path),
-        worktree.branch === null ? null : readBranchLastCommitTimestamp(worktree.path, worktree.branch),
+        worktree.branch === null
+            ? null
+            : readBranchLastCommitTimestamp(worktree.path, worktree.branch),
     ]);
-    const health = healthResult.status === 'fulfilled' ? healthResult.value : null;
-    const lastCommitTimestamp = lastCommitResult.status === 'fulfilled'
-        ? lastCommitResult.value
-        : null;
+    const health = healthResult.status === "fulfilled" ? healthResult.value : null;
+    const lastCommitTimestamp = lastCommitResult.status === "fulfilled" ? lastCommitResult.value : null;
     return {
         ...worktree,
         lastCommitTimestamp,
-        status: health?.status ?? 'unknown',
+        status: health?.status ?? "unknown",
         upstream: buildUpstreamState(worktree.branch, health),
     };
 }
 function buildUpstreamState(branch, health) {
     if (branch === null) {
-        return { kind: 'detached' };
+        return { kind: "detached" };
     }
     if (health === null) {
-        return { kind: 'unknown' };
+        return { kind: "unknown" };
     }
     if (!health.hasUpstream) {
-        return { kind: 'no-upstream' };
+        return { kind: "no-upstream" };
     }
     if (health.upstreamGone) {
-        return { kind: 'stale' };
+        return { kind: "stale" };
     }
     return {
         ahead: health.ahead,
         behind: health.behind,
-        kind: 'tracked',
+        kind: "tracked",
     };
 }
 export function serializeWorktreeInfo(info) {
@@ -54,26 +54,26 @@ export function formatWorktreeHint(info) {
     if (info.lastCommitTimestamp !== null) {
         details.push(`last: ${formatRelativeAge(info.lastCommitTimestamp)}`);
     }
-    return `${info.path} (${details.join(', ')})`;
+    return `${info.path} (${details.join(", ")})`;
 }
 export function formatUpstreamState(upstream) {
-    if (upstream.kind === 'detached') {
-        return 'n/a';
+    if (upstream.kind === "detached") {
+        return "n/a";
     }
-    if (upstream.kind === 'no-upstream') {
-        return 'no-upstream';
+    if (upstream.kind === "no-upstream") {
+        return "no-upstream";
     }
-    if (upstream.kind === 'stale') {
-        return 'gone';
+    if (upstream.kind === "stale") {
+        return "gone";
     }
-    if (upstream.kind === 'unknown') {
-        return 'unknown';
+    if (upstream.kind === "unknown") {
+        return "unknown";
     }
     return formatAheadBehind(upstream.ahead, upstream.behind);
 }
 function formatAheadBehind(ahead, behind) {
     if (ahead === 0 && behind === 0) {
-        return 'up to date';
+        return "up to date";
     }
     if (ahead === 0) {
         return `behind ${behind}`;
@@ -84,16 +84,18 @@ function formatAheadBehind(ahead, behind) {
     return `ahead ${ahead}, behind ${behind}`;
 }
 export function formatLastCommit(timestampSeconds) {
-    return timestampSeconds === null ? 'n/a' : formatRelativeAge(timestampSeconds);
+    return timestampSeconds === null
+        ? "n/a"
+        : formatRelativeAge(timestampSeconds);
 }
 export function formatRelativeAge(timestampSeconds) {
     const ageSeconds = Math.max(0, Math.floor(Date.now() / 1000) - timestampSeconds);
     const units = [
-        { label: 'y', seconds: 365 * 24 * 60 * 60 },
-        { label: 'mo', seconds: 30 * 24 * 60 * 60 },
-        { label: 'd', seconds: 24 * 60 * 60 },
-        { label: 'h', seconds: 60 * 60 },
-        { label: 'm', seconds: 60 },
+        { label: "y", seconds: 365 * 24 * 60 * 60 },
+        { label: "mo", seconds: 30 * 24 * 60 * 60 },
+        { label: "d", seconds: 24 * 60 * 60 },
+        { label: "h", seconds: 60 * 60 },
+        { label: "m", seconds: 60 },
     ];
     for (const unit of units) {
         const value = Math.floor(ageSeconds / unit.seconds);
@@ -101,5 +103,5 @@ export function formatRelativeAge(timestampSeconds) {
             return `${value}${unit.label} ago`;
         }
     }
-    return 'just now';
+    return "just now";
 }

package/dist/worktree-management.d.ts

@@ -1,4 +1,4 @@
-import { type RepositoryContext, type WorktreeEntry } from './repo.js';
+import { type RepositoryContext, type WorktreeEntry } from "./repo.js";
 export interface LinkedWorktreeContext {
     linkedWorktrees: WorktreeEntry[];
     repository: RepositoryContext;

package/dist/worktree-management.js

@@ -1,9 +1,9 @@
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
-import { detectRepository, listWorktrees } from './repo.js';
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { detectRepository, listWorktrees, } from "./repo.js";
 const execFileAsync = promisify(execFile);
 // Force English output so error message string matching is locale-independent.
-const GIT_ENV = { ...process.env, LC_ALL: 'C' };
+const GIT_ENV = { ...process.env, LC_ALL: "C" };
 export async function loadLinkedWorktrees(cwd) {
     const repository = await detectRepository(cwd);
     const linkedWorktrees = (await listWorktrees(cwd)).filter((worktree) => worktree.path !== repository.repoRoot);
@@ -13,23 +13,38 @@ export async function loadLinkedWorktrees(cwd) {
     };
 }
 export async function removeWorktree(repoRoot, worktreePath) {
-    await execFileAsync('git', ['worktree', 'remove', worktreePath], { cwd: repoRoot, env: GIT_ENV });
+    await execFileAsync("git", ["worktree", "remove", worktreePath], {
+        cwd: repoRoot,
+        env: GIT_ENV,
+    });
 }
 export async function forceRemoveWorktree(repoRoot, worktreePath) {
-    await execFileAsync('git', ['worktree', 'remove', '--force', worktreePath], { cwd: repoRoot, env: GIT_ENV });
+    await execFileAsync("git", ["worktree", "remove", "--force", worktreePath], {
+        cwd: repoRoot,
+        env: GIT_ENV,
+    });
 }
 export async function deleteBranch(repoRoot, branch) {
-    await execFileAsync('git', ['branch', '-d', branch], { cwd: repoRoot, env: GIT_ENV });
+    await execFileAsync("git", ["branch", "-d", branch], {
+        cwd: repoRoot,
+        env: GIT_ENV,
+    });
 }
 export async function forceDeleteBranch(repoRoot, branch) {
-    await execFileAsync('git', ['branch', '-D', branch], { cwd: repoRoot, env: GIT_ENV });
+    await execFileAsync("git", ["branch", "-D", branch], {
+        cwd: repoRoot,
+        env: GIT_ENV,
+    });
 }
 export function isWorktreeDirtyError(error) {
-    return hasStderr(error) && error.stderr.includes('contains modified or untracked files');
+    return (hasStderr(error) &&
+        error.stderr.includes("contains modified or untracked files"));
 }
 export function isBranchUnmergedError(error) {
-    return hasStderr(error) && error.stderr.includes('is not fully merged');
+    return hasStderr(error) && error.stderr.includes("is not fully merged");
 }
 function hasStderr(error) {
-    return error instanceof Error && 'stderr' in error && typeof error.stderr === 'string';
+    return (error instanceof Error &&
+        "stderr" in error &&
+        typeof error.stderr === "string");
 }

package/dist/worktree-prompts.js

@@ -1,8 +1,8 @@
-import { confirm, isCancel } from '@clack/prompts';
+import { confirm, isCancel } from "@clack/prompts";
 export async function defaultConfirmForceRemoveWorktree(worktreePath) {
     const choice = await confirm({
-        active: 'Yes',
-        inactive: 'No',
+        active: "Yes",
+        inactive: "No",
         initialValue: false,
         message: `Worktree at ${worktreePath} has untracked or modified files. Force remove?`,
     });
@@ -10,8 +10,8 @@ export async function defaultConfirmForceRemoveWorktree(worktreePath) {
 }
 export async function defaultConfirmForceDeleteBranch(branch) {
     const choice = await confirm({
-        active: 'Yes',
-        inactive: 'No',
+        active: "Yes",
+        inactive: "No",
         initialValue: false,
         message: `Branch ${branch} has unmerged commits. Force delete?`,
     });

package/man/man1/gji-back.1

@@ -1,4 +1,4 @@
-.TH GJI\-BACK 1 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-BACK 1 "May 2026" "gji 0.7.0" "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 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-CLEAN 1 "May 2026" "gji 0.7.0" "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 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-COMPLETION 1 "May 2026" "gji 0.7.0" "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 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-CONFIG 1 "May 2026" "gji 0.7.0" "User Commands"
 .SH NAME
 gji\-config \- manage global config defaults
 .SH SYNOPSIS

package/man/man1/gji-go.1

@@ -1,4 +1,4 @@
-.TH GJI\-GO 1 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-GO 1 "May 2026" "gji 0.7.0" "User Commands"
 .SH NAME
 gji\-go \- print or select a worktree path
 .SH SYNOPSIS

package/man/man1/gji-history.1

@@ -1,4 +1,4 @@
-.TH GJI\-HISTORY 1 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-HISTORY 1 "May 2026" "gji 0.7.0" "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 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-INIT 1 "May 2026" "gji 0.7.0" "User Commands"
 .SH NAME
 gji\-init \- print or install shell integration
 .SH SYNOPSIS

package/man/man1/gji-ls.1

@@ -1,4 +1,4 @@
-.TH GJI\-LS 1 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-LS 1 "May 2026" "gji 0.7.0" "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 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-NEW 1 "May 2026" "gji 0.7.0" "User Commands"
 .SH NAME
 gji\-new \- create a new branch or detached linked worktree
 .SH SYNOPSIS

package/man/man1/gji-open.1

@@ -1,4 +1,4 @@
-.TH GJI\-OPEN 1 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-OPEN 1 "May 2026" "gji 0.7.0" "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 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-PR 1 "May 2026" "gji 0.7.0" "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 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-REMOVE 1 "May 2026" "gji 0.7.0" "User Commands"
 .SH NAME
 gji\-remove \- remove a linked worktree and delete its branch when present
 .SH SYNOPSIS

package/man/man1/gji-root.1

@@ -1,4 +1,4 @@
-.TH GJI\-ROOT 1 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-ROOT 1 "May 2026" "gji 0.7.0" "User Commands"
 .SH NAME
 gji\-root \- print the main repository root path
 .SH SYNOPSIS

package/man/man1/gji-status.1

@@ -1,4 +1,4 @@
-.TH GJI\-STATUS 1 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-STATUS 1 "May 2026" "gji 0.7.0" "User Commands"
 .SH NAME
 gji\-status \- summarize repository and worktree health
 .SH SYNOPSIS

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

@@ -0,0 +1,23 @@
+.TH GJI\-SYNC\-FILES 1 "May 2026" "gji 0.7.0" "User Commands"
+.SH NAME
+gji\-sync\-files \- manage local files copied into new worktrees
+.SH SYNOPSIS
+.B gji sync\-files [\fIoptions\fR] [options] [command]
+.SH DESCRIPTION
+manage local files copied into new worktrees
+.SH OPTIONS
+.TP
+.B \-\-json
+emit JSON instead of human\-readable output
+.SH SUBCOMMANDS
+.TP
+.B list
+list files synced into new worktrees for this repo
+.TP
+.B add
+add repo\-local sync files to global config
+.TP
+.B remove
+remove repo\-local sync files from global config
+.SH "SEE ALSO"
+.BR gji (1)

package/man/man1/gji-sync.1

@@ -1,4 +1,4 @@
-.TH GJI\-SYNC 1 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-SYNC 1 "May 2026" "gji 0.7.0" "User Commands"
 .SH NAME
 gji\-sync \- fetch and update one or all worktrees
 .SH SYNOPSIS

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

@@ -1,4 +1,4 @@
-.TH GJI\-TRIGGER\-HOOK 1 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-TRIGGER\-HOOK 1 "May 2026" "gji 0.7.0" "User Commands"
 .SH NAME
 gji\-trigger\-hook \- run a named hook (afterCreate, afterEnter, beforeRemove) in the current worktree
 .SH SYNOPSIS

package/man/man1/gji-warp.1

@@ -1,4 +1,4 @@
-.TH GJI\-WARP 1 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI\-WARP 1 "May 2026" "gji 0.7.0" "User Commands"
 .SH NAME
 gji\-warp \- jump to any worktree across all known repos
 .SH SYNOPSIS

package/man/man1/gji.1

@@ -1,4 +1,4 @@
-.TH GJI 1 "May 2026" "gji 0.6.1" "User Commands"
+.TH GJI 1 "May 2026" "gji 0.7.0" "User Commands"
 .SH NAME
 gji \- Context switching without the mess.
 .SH SYNOPSIS
@@ -46,6 +46,9 @@ summarize repository and worktree health
 .B sync [options]
 fetch and update one or all worktrees
 .TP
+.B sync\-files [options] [command]
+manage local files copied into new worktrees
+.TP
 .B ls [options]
 list active worktrees
 .TP
@@ -81,6 +84,7 @@ output the version number
 .BR gji\-root (1),
 .BR gji\-status (1),
 .BR gji\-sync (1),
+.BR gji\-sync\-files (1),
 .BR gji\-ls (1),
 .BR gji\-clean (1),
 .BR gji\-remove (1),