@solaqua/gji 0.4.1 → 0.5.0

package/dist/go.js

@@ -4,6 +4,7 @@ import { loadEffectiveConfig } from './config.js';
 import { readWorktreeHealth } from './git.js';
 import { isHeadless } from './headless.js';
 import { extractHooks, runHook } from './hooks.js';
+import { appendHistory } from './history.js';
 import { detectRepository, listWorktrees, sortByCurrentFirst } from './repo.js';
 import { writeShellOutput } from './shell-handoff.js';
 const GO_OUTPUT_FILE_ENV = 'GJI_GO_OUTPUT_FILE';
@@ -36,6 +37,7 @@ export function createGoCommand(dependencies = {}) {
         const config = await loadEffectiveConfig(repository.repoRoot, undefined, options.stderr);
         const hooks = extractHooks(config);
         await runHook(hooks.afterEnter, resolvedPath, { branch: chosenWorktree?.branch ?? undefined, path: resolvedPath, repo: basename(repository.repoRoot) }, options.stderr);
+        appendHistory(resolvedPath, chosenWorktree?.branch ?? null).catch(() => undefined);
         await writeShellOutput(GO_OUTPUT_FILE_ENV, resolvedPath, options.stdout);
         return 0;
     };

package/dist/history-command.d.ts

@@ -0,0 +1,7 @@
+export interface HistoryCommandOptions {
+    cwd: string;
+    home?: string;
+    json?: boolean;
+    stdout: (chunk: string) => void;
+}
+export declare function runHistoryCommand(options: HistoryCommandOptions): Promise<number>;

package/dist/history-command.js

@@ -0,0 +1,15 @@
+import { loadHistory } from './history.js';
+import { formatHistoryList } from './back.js';
+export async function runHistoryCommand(options) {
+    const history = await loadHistory(options.home);
+    if (options.json) {
+        options.stdout(`${JSON.stringify(history, null, 2)}\n`);
+        return 0;
+    }
+    if (history.length === 0) {
+        options.stdout('No navigation history.\n');
+        return 0;
+    }
+    options.stdout(formatHistoryList(history, options.cwd));
+    return 0;
+}

package/dist/history.d.ts

@@ -0,0 +1,9 @@
+export declare const HISTORY_FILE_NAME = "history.json";
+export interface HistoryEntry {
+    branch: string | null;
+    path: string;
+    timestamp: number;
+}
+export declare function HISTORY_FILE_PATH(home?: string): string;
+export declare function loadHistory(home?: string): Promise<HistoryEntry[]>;
+export declare function appendHistory(path: string, branch: string | null, home?: string): Promise<void>;

package/dist/history.js

@@ -0,0 +1,46 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { GLOBAL_CONFIG_DIRECTORY } from './config.js';
+export const HISTORY_FILE_NAME = 'history.json';
+const MAX_HISTORY_ENTRIES = 50;
+export function HISTORY_FILE_PATH(home = homedir()) {
+    const configDir = process.env.GJI_CONFIG_DIR;
+    if (configDir) {
+        return join(resolve(configDir), HISTORY_FILE_NAME);
+    }
+    return join(home, GLOBAL_CONFIG_DIRECTORY, HISTORY_FILE_NAME);
+}
+export async function loadHistory(home = homedir()) {
+    const path = HISTORY_FILE_PATH(home);
+    try {
+        const raw = await readFile(path, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter(isHistoryEntry);
+    }
+    catch {
+        return [];
+    }
+}
+export async function appendHistory(path, branch, home = homedir()) {
+    const historyPath = HISTORY_FILE_PATH(home);
+    const existing = await loadHistory(home);
+    // Skip if the most recent entry is the same path (no-op navigation)
+    if (existing.length > 0 && existing[0].path === path) {
+        return;
+    }
+    const entry = { branch, path, timestamp: Date.now() };
+    const next = [entry, ...existing].slice(0, MAX_HISTORY_ENTRIES);
+    await mkdir(dirname(historyPath), { recursive: true });
+    await writeFile(historyPath, `${JSON.stringify(next, null, 2)}\n`, 'utf8');
+}
+function isHistoryEntry(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'path' in value &&
+        typeof value.path === 'string' &&
+        'timestamp' in value &&
+        typeof value.timestamp === 'number');
+}

package/dist/init.js

@@ -21,6 +21,13 @@ const SHELL_WRAPPED_COMMANDS = [
         names: ['pr'],
         tempPrefix: 'gji-pr',
     },
+    {
+        bypassOption: '--print',
+        commandName: 'back',
+        envVar: 'GJI_BACK_OUTPUT_FILE',
+        names: ['back'],
+        tempPrefix: 'gji-back',
+    },
     {
         bypassOption: '--print',
         commandName: 'go',

package/dist/new.js

@@ -6,6 +6,7 @@ import { isCancel, text } from '@clack/prompts';
 import { loadEffectiveConfig, resolveConfigString } from './config.js';
 import { syncFiles } from './file-sync.js';
 import { extractHooks, runHook } from './hooks.js';
+import { appendHistory } from './history.js';
 import { isHeadless } from './headless.js';
 import { maybeRunInstallPrompt } from './install-prompt.js';
 import { pathExists, promptForPathConflict } from './conflict.js';
@@ -105,6 +106,7 @@ export function createNewCommand(dependencies = {}) {
             else {
                 const choice = await prompt(worktreePath);
                 if (choice === 'reuse') {
+                    appendHistory(worktreePath, worktreeName).catch(() => undefined);
                     await writeOutput(worktreePath, options.stdout);
                     return 0;
                 }
@@ -147,6 +149,7 @@ export function createNewCommand(dependencies = {}) {
             options.stdout(`${JSON.stringify({ branch: worktreeName, path: worktreePath }, null, 2)}\n`);
         }
         else {
+            await appendHistory(worktreePath, worktreeName);
             await writeOutput(worktreePath, options.stdout);
         }
         return 0;

package/dist/pr.js

@@ -6,6 +6,7 @@ import { loadEffectiveConfig, resolveConfigString } from './config.js';
 import { syncFiles } from './file-sync.js';
 import { pathExists, promptForPathConflict } from './conflict.js';
 import { extractHooks, runHook } from './hooks.js';
+import { appendHistory } from './history.js';
 import { isHeadless } from './headless.js';
 import { maybeRunInstallPrompt } from './install-prompt.js';
 import { detectRepository, resolveWorktreePath } from './repo.js';
@@ -58,6 +59,7 @@ export function createPrCommand(dependencies = {}) {
             }
             const choice = await prompt(worktreePath);
             if (choice === 'reuse') {
+                appendHistory(worktreePath, branchName).catch(() => undefined);
                 await writeOutput(worktreePath, options.stdout);
                 return 0;
             }
@@ -112,6 +114,7 @@ export function createPrCommand(dependencies = {}) {
             options.stdout(`${JSON.stringify({ branch: branchName, path: worktreePath }, null, 2)}\n`);
         }
         else {
+            await appendHistory(worktreePath, branchName);
             await writeOutput(worktreePath, options.stdout);
         }
         return 0;

package/man/man1/gji-back.1

@@ -0,0 +1,13 @@
+.TH GJI\-BACK 1 "May 2026" "gji 0.5.0" "User Commands"
+.SH NAME
+gji\-back \- navigate to the previously visited worktree, optionally N steps back
+.SH SYNOPSIS
+.B gji back [\fIoptions\fR] [options] [n]
+.SH DESCRIPTION
+navigate to the previously visited worktree, optionally N steps back
+.SH OPTIONS
+.TP
+.B \-\-print
+print the resolved worktree path explicitly
+.SH "SEE ALSO"
+.BR gji (1)

package/man/man1/gji-clean.1

@@ -1,4 +1,4 @@
-.TH GJI\-CLEAN 1 "May 2026" "gji 0.4.1" "User Commands"
+.TH GJI\-CLEAN 1 "May 2026" "gji 0.5.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.4.1" "User Commands"
+.TH GJI\-COMPLETION 1 "May 2026" "gji 0.5.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.4.1" "User Commands"
+.TH GJI\-CONFIG 1 "May 2026" "gji 0.5.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.4.1" "User Commands"
+.TH GJI\-GO 1 "May 2026" "gji 0.5.0" "User Commands"
 .SH NAME
 gji\-go \- print or select a worktree path
 .SH SYNOPSIS

package/man/man1/gji-history.1

@@ -0,0 +1,13 @@
+.TH GJI\-HISTORY 1 "May 2026" "gji 0.5.0" "User Commands"
+.SH NAME
+gji\-history \- show navigation history
+.SH SYNOPSIS
+.B gji history [\fIoptions\fR] [options]
+.SH DESCRIPTION
+show navigation history
+.SH OPTIONS
+.TP
+.B \-\-json
+print history as JSON
+.SH "SEE ALSO"
+.BR gji (1)

package/man/man1/gji-init.1

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

package/man/man1/gji-pr.1

@@ -1,4 +1,4 @@
-.TH GJI\-PR 1 "May 2026" "gji 0.4.1" "User Commands"
+.TH GJI\-PR 1 "May 2026" "gji 0.5.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.4.1" "User Commands"
+.TH GJI\-REMOVE 1 "May 2026" "gji 0.5.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.4.1" "User Commands"
+.TH GJI\-ROOT 1 "May 2026" "gji 0.5.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.4.1" "User Commands"
+.TH GJI\-STATUS 1 "May 2026" "gji 0.5.0" "User Commands"
 .SH NAME
 gji\-status \- summarize repository and worktree health
 .SH SYNOPSIS

package/man/man1/gji-sync.1

@@ -1,4 +1,4 @@
-.TH GJI\-SYNC 1 "May 2026" "gji 0.4.1" "User Commands"
+.TH GJI\-SYNC 1 "May 2026" "gji 0.5.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.4.1" "User Commands"
+.TH GJI\-TRIGGER\-HOOK 1 "May 2026" "gji 0.5.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.1

@@ -1,4 +1,4 @@
-.TH GJI 1 "May 2026" "gji 0.4.1" "User Commands"
+.TH GJI 1 "May 2026" "gji 0.5.0" "User Commands"
 .SH NAME
 gji \- Context switching without the mess.
 .SH SYNOPSIS
@@ -23,6 +23,12 @@ print shell completion definitions
 .B pr [options] <ref>
 fetch a pull request by number, #number, or URL into a linked worktree
 .TP
+.B back [options] [n]
+navigate to the previously visited worktree, optionally N steps back
+.TP
+.B history [options]
+show navigation history
+.TP
 .B go [options] [branch]
 print or select a worktree path
 .TP
@@ -60,6 +66,8 @@ output the version number
 .BR gji\-init (1),
 .BR gji\-completion (1),
 .BR gji\-pr (1),
+.BR gji\-back (1),
+.BR gji\-history (1),
 .BR gji\-go (1),
 .BR gji\-root (1),
 .BR gji\-status (1),

package/package.json

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