@solaqua/gji 0.9.0 → 0.10.0

package/README.md

@@ -107,8 +107,9 @@ gji status
 gji go feature/dark-mode
 gji go main
 
-# open any worktree in an editor (interactive picker)
+# open the current worktree in an editor
 gji open
+gji open --select                # choose another worktree interactively
 gji open feature/dark-mode --editor code
 
 # clean up when done
@@ -127,6 +128,7 @@ Set `worktreePath` in your config to use a different base (e.g. `"~/worktrees"`
 
 ```sh
 gji new feature/auth-refactor     # new branch + worktree
+gji new feature/auth-tests --from-current  # branch from the current worktree
 gji new --detached                # scratch space, auto-named
 
 gji pr 1234                       # checkout PR locally
@@ -229,10 +231,10 @@ path=$(gji root --print)
 
 | Command | Description |
 |---|---|
-| `gji new [branch] [--detached] [--open] [--editor <cli>] [--json]` | create branch + worktree, cd in (validates branch name against Git rules) |
+| `gji new [branch] [--from-current] [--detached] [--open] [--editor <cli>] [--json]` | create branch + worktree, optionally based on the current worktree |
 | `gji pr <ref> [--json]` | fetch PR ref, create worktree, cd in |
 | `gji pr open [branch|#N] [--select]` | open the current worktree PR, or choose a linked worktree with `--select` |
-| `gji open [branch] [--editor <cli>] [--save] [--workspace]` | open a worktree in an editor |
+| `gji open [branch] [--select] [--editor <cli>] [--save] [--workspace]` | open the current or selected worktree in an editor |
 | `gji go [branch] [--print]` | jump to a worktree |
 | `gji root [--print]` | jump to the main repo root |
 | `gji status [--json]` | repo overview, worktree health, ahead/behind |

package/dist/cli.js

@@ -120,6 +120,7 @@ function registerCommands(program) {
         .description("create a new branch or detached linked worktree")
         .option("-f, --force", "remove and recreate the worktree if the target path already exists")
         .option("--detached", "create a detached worktree without a branch")
+        .option("--from-current", "base the new branch on the current worktree instead of the main worktree (cannot be combined with --detached)")
         .option("--open", "open the new worktree in an editor after creation")
         .option("--editor <cli>", "editor CLI to use with --open (code, cursor, zed, …)")
         .option("--dry-run", "show what would be created without executing any git commands or writing files")
@@ -167,6 +168,7 @@ function registerCommands(program) {
     program
         .command("open [branch]")
         .description("open the worktree in an editor")
+        .option("--select", "choose a worktree with the interactive selector")
         .option("--editor <cli>", "editor CLI to use (code, cursor, zed, windsurf, subl, …)")
         .option("--save", "save the chosen editor to global config")
         .option("--workspace", "generate a .code-workspace file before opening (VS Code / Cursor / Windsurf)")
@@ -277,6 +279,7 @@ function attachCommandActions(program, options) {
             detached: commandOptions.detached,
             dryRun: commandOptions.dryRun,
             editor: commandOptions.editor,
+            fromCurrent: commandOptions.fromCurrent,
             force: commandOptions.force,
             json: commandOptions.json,
             open: commandOptions.open,
@@ -397,6 +400,7 @@ function attachCommandActions(program, options) {
             cwd: options.cwd,
             editor: commandOptions.editor,
             save: commandOptions.save,
+            select: commandOptions.select,
             stderr: options.stderr,
             stdout: options.stdout,
             workspace: commandOptions.workspace,

package/dist/gji-bundle.mjs

@@ -16060,7 +16060,7 @@ _gji_completion() {
 
   case "$command_name" in
     new)
-      COMPREPLY=( $(compgen -W "--detached --force --open --editor --dry-run --json --help" -- "$cur") )
+      COMPREPLY=( $(compgen -W "--detached --from-current --force --open --editor --dry-run --json --help" -- "$cur") )
       ;;
     init)
       COMPREPLY=( $(compgen -W "${shells} --write --json --help" -- "$cur") )
@@ -16102,7 +16102,7 @@ _gji_completion() {
       COMPREPLY=( $(compgen -W "--json --help" -- "$cur") )
       ;;
     open)
-      COMPREPLY=( $(compgen -W "$(__gji_worktree_branches) --editor --save --workspace --help" -- "$cur") )
+      COMPREPLY=( $(compgen -W "$(__gji_worktree_branches) --editor --select --save --workspace --help" -- "$cur") )
       ;;
     go|jump)
       COMPREPLY=( $(compgen -W "$(__gji_worktree_branches) --print --help" -- "$cur") )
@@ -16297,6 +16297,7 @@ complete -c gji -f
 ${commandLines}
 
 complete -c gji -n '__fish_seen_subcommand_from new' -l detached -d 'create a detached worktree without a branch'
+complete -c gji -n '__fish_seen_subcommand_from new' -l from-current -d 'base the new branch on the current worktree instead of the main worktree'
 complete -c gji -n '__fish_seen_subcommand_from new' -l force -d 'remove and recreate the worktree if the target path already exists'
 complete -c gji -n '__fish_seen_subcommand_from new' -l open -d 'open the new worktree in an editor after creation'
 complete -c gji -n '__fish_seen_subcommand_from new' -l editor -r -d 'editor CLI to use with --open (code, cursor, zed, \u2026)'
@@ -16326,6 +16327,7 @@ complete -c gji -n '__fish_seen_subcommand_from back' -l print -d 'print the res
 complete -c gji -n '__fish_seen_subcommand_from history' -l json -d 'print history as JSON'
 
 complete -c gji -n '__fish_seen_subcommand_from open' -l editor -r -d 'editor CLI to use (code, cursor, zed, windsurf, subl, \u2026)'
+complete -c gji -n '__fish_seen_subcommand_from open' -l select -d 'choose a worktree with the interactive selector'
 complete -c gji -n '__fish_seen_subcommand_from open' -l save -d 'save the chosen editor to global config'
 complete -c gji -n '__fish_seen_subcommand_from open' -l workspace -d 'generate a .code-workspace file before opening (VS Code / Cursor / Windsurf)'
 complete -c gji -n '__fish_seen_subcommand_from open' -a '(__gji_worktree_branches)' -d 'worktree branch'
@@ -16451,7 +16453,7 @@ fi
 
 case "\${words[2]}" in
   new)
-    _arguments '--detached[create a detached worktree without a branch]' '--force[remove and recreate the worktree if the target path already exists]' '--open[open the new worktree in an editor after creation]' '--editor[editor CLI to use with --open (code, cursor, zed, \u2026)]:editor:' '--dry-run[show what would be created without executing any git commands or writing files]' '--json[emit JSON on success or error instead of human-readable output]' '2:branch: '
+    _arguments '--detached[create a detached worktree without a branch]' '--from-current[base the new branch on the current worktree instead of the main worktree]' '--force[remove and recreate the worktree if the target path already exists]' '--open[open the new worktree in an editor after creation]' '--editor[editor CLI to use with --open (code, cursor, zed, \u2026)]:editor:' '--dry-run[show what would be created without executing any git commands or writing files]' '--json[emit JSON on success or error instead of human-readable output]' '2:branch: '
     ;;
   init)
     _arguments '--write[write the integration to the shell config file]' '--json[emit a JSON error in non-interactive mode]' '2:shell:(${shells})'
@@ -16482,7 +16484,7 @@ case "\${words[2]}" in
     _arguments '--json[print history as JSON]'
     ;;
   open)
-    _arguments '--editor[editor CLI to use (code, cursor, zed, windsurf, subl, \u2026)]:editor:' '--save[save the chosen editor to global config]' '--workspace[generate a .code-workspace file before opening (VS Code / Cursor / Windsurf)]' '2:branch:->worktrees'
+    _arguments '--editor[editor CLI to use (code, cursor, zed, windsurf, subl, \u2026)]:editor:' '--select[choose a worktree with the interactive selector]' '--save[save the chosen editor to global config]' '--workspace[generate a .code-workspace file before opening (VS Code / Cursor / Windsurf)]' '2:branch:->worktrees'
     ;;
   go|jump)
     _arguments '--print[print the resolved worktree path explicitly]' '2:branch:->worktrees'
@@ -17765,6 +17767,17 @@ function createNewCommand(dependencies = {}) {
   const prompt = dependencies.promptForPathConflict ?? promptForPathConflict;
   const spawnEditor = dependencies.spawnEditor ?? defaultSpawnEditor;
   return async function runNewCommand2(options) {
+    if (options.detached && options.fromCurrent) {
+      const message = "--from-current cannot be used with --detached";
+      if (options.json) {
+        options.stderr(`${JSON.stringify({ error: message }, null, 2)}
+`);
+      } else {
+        options.stderr(`gji new: ${message}
+`);
+      }
+      return 1;
+    }
     const repository = await detectRepository(options.cwd);
     const config = await loadEffectiveConfig(
       repository.repoRoot,
@@ -17908,7 +17921,15 @@ function createNewCommand(dependencies = {}) {
       return 0;
     }
     await mkdir5(dirname7(worktreePath), { recursive: true });
-    const gitArgs = options.detached ? ["worktree", "add", "--detach", worktreePath] : await localBranchExists(repository.repoRoot, worktreeName) ? ["worktree", "add", worktreePath, worktreeName] : ["worktree", "add", "-b", worktreeName, worktreePath];
+    const startPoint = options.fromCurrent && !options.detached ? await resolveCurrentWorktreeHead(options.cwd) : void 0;
+    const gitArgs = options.detached ? ["worktree", "add", "--detach", worktreePath] : await localBranchExists(repository.repoRoot, worktreeName) ? ["worktree", "add", worktreePath, worktreeName] : [
+      "worktree",
+      "add",
+      "-b",
+      worktreeName,
+      worktreePath,
+      ...startPoint ? [startPoint] : []
+    ];
     await execFileAsync5("git", gitArgs, { cwd: repository.repoRoot });
     const syncPatterns = Array.isArray(config.syncFiles) ? config.syncFiles.filter(
       (p2) => typeof p2 === "string"
@@ -18123,6 +18144,11 @@ async function localBranchExists(repoRoot, branchName) {
     return false;
   }
 }
+async function resolveCurrentWorktreeHead(cwd) {
+  return execFileAsync5("git", ["rev-parse", "--verify", "HEAD"], { cwd }).then(
+    ({ stdout: stdout2 }) => stdout2.trim()
+  );
+}
 async function writeOutput(worktreePath, stdout2) {
   await writeShellOutput(NEW_OUTPUT_FILE_ENV, worktreePath, stdout2);
 }
@@ -19119,6 +19145,16 @@ function createOpenCommand(dependencies = {}) {
   const promptForWorktree2 = dependencies.promptForWorktree ?? defaultPromptForWorktree;
   const spawnEditor = dependencies.spawnEditor ?? defaultSpawnEditor;
   return async function runOpenCommand2(options) {
+    if (options.select && options.branch !== void 0) {
+      options.stderr("gji open: --select cannot be used with a branch\n");
+      return 1;
+    }
+    if (options.select && isHeadless()) {
+      options.stderr(
+        "gji open --select: selector is unavailable in non-interactive mode (GJI_NO_TUI=1)\n"
+      );
+      return 1;
+    }
     const [worktrees, repository] = await Promise.all([
       listWorktrees(options.cwd),
       detectRepository(options.cwd)
@@ -19144,9 +19180,13 @@ function createOpenCommand(dependencies = {}) {
       }
       targetPath = match.worktree.path;
       targetWorktree = match.worktree;
-    } else if (isHeadless()) {
+    } else if (!options.select) {
       targetWorktree = worktrees.find((w2) => w2.isCurrent);
-      targetPath = targetWorktree?.path ?? options.cwd;
+      if (!targetWorktree) {
+        options.stderr("gji open: unable to identify the current worktree\n");
+        return 1;
+      }
+      targetPath = targetWorktree.path;
     } else {
       const entries = await buildWorktreePromptEntries(
         worktrees.map((worktree) => ({
@@ -20602,7 +20642,10 @@ function registerCommands(program2) {
   program2.command("new [branch]").description("create a new branch or detached linked worktree").option(
     "-f, --force",
     "remove and recreate the worktree if the target path already exists"
-  ).option("--detached", "create a detached worktree without a branch").option("--open", "open the new worktree in an editor after creation").option(
+  ).option("--detached", "create a detached worktree without a branch").option(
+    "--from-current",
+    "base the new branch on the current worktree instead of the main worktree (cannot be combined with --detached)"
+  ).option("--open", "open the new worktree in an editor after creation").option(
     "--editor <cli>",
     "editor CLI to use with --open (code, cursor, zed, \u2026)"
   ).option(
@@ -20631,7 +20674,7 @@ function registerCommands(program2) {
     "navigate to the previously visited worktree, optionally N steps back"
   ).option("--print", "print the resolved worktree path explicitly").action(notImplemented("back"));
   program2.command("history").description("show navigation history").option("--json", "print history as JSON").action(notImplemented("history"));
-  program2.command("open [branch]").description("open the worktree in an editor").option(
+  program2.command("open [branch]").description("open the worktree in an editor").option("--select", "choose a worktree with the interactive selector").option(
     "--editor <cli>",
     "editor CLI to use (code, cursor, zed, windsurf, subl, \u2026)"
   ).option("--save", "save the chosen editor to global config").option(
@@ -20691,6 +20734,7 @@ function attachCommandActions(program2, options) {
         detached: commandOptions2.detached,
         dryRun: commandOptions2.dryRun,
         editor: commandOptions2.editor,
+        fromCurrent: commandOptions2.fromCurrent,
         force: commandOptions2.force,
         json: commandOptions2.json,
         open: commandOptions2.open
@@ -20808,6 +20852,7 @@ function attachCommandActions(program2, options) {
         cwd: options.cwd,
         editor: commandOptions2.editor,
         save: commandOptions2.save,
+        select: commandOptions2.select,
         stderr: options.stderr,
         stdout: options.stdout,
         workspace: commandOptions2.workspace

package/dist/new.d.ts

@@ -7,6 +7,7 @@ export interface NewCommandOptions {
     detached?: boolean;
     dryRun?: boolean;
     editor?: string;
+    fromCurrent?: boolean;
     force?: boolean;
     json?: boolean;
     open?: boolean;

package/dist/new.js

@@ -21,6 +21,16 @@ export function createNewCommand(dependencies = {}) {
     const prompt = dependencies.promptForPathConflict ?? promptForPathConflict;
     const spawnEditor = dependencies.spawnEditor ?? defaultSpawnEditor;
     return async function runNewCommand(options) {
+        if (options.detached && options.fromCurrent) {
+            const message = "--from-current cannot be used with --detached";
+            if (options.json) {
+                options.stderr(`${JSON.stringify({ error: message }, null, 2)}\n`);
+            }
+            else {
+                options.stderr(`gji new: ${message}\n`);
+            }
+            return 1;
+        }
         const repository = await detectRepository(options.cwd);
         const config = await loadEffectiveConfig(repository.repoRoot, undefined, options.stderr);
         const usesGeneratedDetachedName = options.detached && options.branch === undefined;
@@ -141,11 +151,21 @@ export function createNewCommand(dependencies = {}) {
             return 0;
         }
         await mkdir(dirname(worktreePath), { recursive: true });
+        const startPoint = options.fromCurrent && !options.detached
+            ? await resolveCurrentWorktreeHead(options.cwd)
+            : undefined;
         const gitArgs = options.detached
             ? ["worktree", "add", "--detach", worktreePath]
             : (await localBranchExists(repository.repoRoot, worktreeName))
                 ? ["worktree", "add", worktreePath, worktreeName]
-                : ["worktree", "add", "-b", worktreeName, worktreePath];
+                : [
+                    "worktree",
+                    "add",
+                    "-b",
+                    worktreeName,
+                    worktreePath,
+                    ...(startPoint ? [startPoint] : []),
+                ];
         await execFileAsync("git", gitArgs, { cwd: repository.repoRoot });
         // Sync files from main worktree before afterCreate so synced files are available to install scripts.
         const syncPatterns = Array.isArray(config.syncFiles)
@@ -333,6 +353,9 @@ async function localBranchExists(repoRoot, branchName) {
         return false;
     }
 }
+async function resolveCurrentWorktreeHead(cwd) {
+    return execFileAsync("git", ["rev-parse", "--verify", "HEAD"], { cwd }).then(({ stdout }) => stdout.trim());
+}
 async function writeOutput(worktreePath, stdout) {
     await writeShellOutput(NEW_OUTPUT_FILE_ENV, worktreePath, stdout);
 }

package/dist/open.d.ts

@@ -6,6 +6,7 @@ export interface OpenCommandOptions {
     cwd: string;
     editor?: string;
     save?: boolean;
+    select?: boolean;
     stderr: (chunk: string) => void;
     stdout: (chunk: string) => void;
     workspace?: boolean;

package/dist/open.js

@@ -16,6 +16,14 @@ export function createOpenCommand(dependencies = {}) {
     const promptForWorktree = dependencies.promptForWorktree ?? defaultPromptForWorktree;
     const spawnEditor = dependencies.spawnEditor ?? defaultSpawnEditor;
     return async function runOpenCommand(options) {
+        if (options.select && options.branch !== undefined) {
+            options.stderr("gji open: --select cannot be used with a branch\n");
+            return 1;
+        }
+        if (options.select && isHeadless()) {
+            options.stderr("gji open --select: selector is unavailable in non-interactive mode (GJI_NO_TUI=1)\n");
+            return 1;
+        }
         const [worktrees, repository] = await Promise.all([
             listWorktrees(options.cwd),
             detectRepository(options.cwd),
@@ -36,9 +44,13 @@ export function createOpenCommand(dependencies = {}) {
             targetPath = match.worktree.path;
             targetWorktree = match.worktree;
         }
-        else if (isHeadless()) {
+        else if (!options.select) {
             targetWorktree = worktrees.find((w) => w.isCurrent);
-            targetPath = targetWorktree?.path ?? options.cwd;
+            if (!targetWorktree) {
+                options.stderr("gji open: unable to identify the current worktree\n");
+                return 1;
+            }
+            targetPath = targetWorktree.path;
         }
         else {
             const entries = await buildWorktreePromptEntries(worktrees.map((worktree) => ({

package/dist/shell-completion.js

@@ -137,7 +137,7 @@ _gji_completion() {
 
   case "$command_name" in
     new)
-      COMPREPLY=( $(compgen -W "--detached --force --open --editor --dry-run --json --help" -- "$cur") )
+      COMPREPLY=( $(compgen -W "--detached --from-current --force --open --editor --dry-run --json --help" -- "$cur") )
       ;;
     init)
       COMPREPLY=( $(compgen -W "${shells} --write --json --help" -- "$cur") )
@@ -179,7 +179,7 @@ _gji_completion() {
       COMPREPLY=( $(compgen -W "--json --help" -- "$cur") )
       ;;
     open)
-      COMPREPLY=( $(compgen -W "$(__gji_worktree_branches) --editor --save --workspace --help" -- "$cur") )
+      COMPREPLY=( $(compgen -W "$(__gji_worktree_branches) --editor --select --save --workspace --help" -- "$cur") )
       ;;
     go|jump)
       COMPREPLY=( $(compgen -W "$(__gji_worktree_branches) --print --help" -- "$cur") )
@@ -364,6 +364,7 @@ complete -c gji -f
 ${commandLines}
 
 complete -c gji -n '__fish_seen_subcommand_from new' -l detached -d 'create a detached worktree without a branch'
+complete -c gji -n '__fish_seen_subcommand_from new' -l from-current -d 'base the new branch on the current worktree instead of the main worktree'
 complete -c gji -n '__fish_seen_subcommand_from new' -l force -d 'remove and recreate the worktree if the target path already exists'
 complete -c gji -n '__fish_seen_subcommand_from new' -l open -d 'open the new worktree in an editor after creation'
 complete -c gji -n '__fish_seen_subcommand_from new' -l editor -r -d 'editor CLI to use with --open (code, cursor, zed, …)'
@@ -393,6 +394,7 @@ complete -c gji -n '__fish_seen_subcommand_from back' -l print -d 'print the res
 complete -c gji -n '__fish_seen_subcommand_from history' -l json -d 'print history as JSON'
 
 complete -c gji -n '__fish_seen_subcommand_from open' -l editor -r -d 'editor CLI to use (code, cursor, zed, windsurf, subl, …)'
+complete -c gji -n '__fish_seen_subcommand_from open' -l select -d 'choose a worktree with the interactive selector'
 complete -c gji -n '__fish_seen_subcommand_from open' -l save -d 'save the chosen editor to global config'
 complete -c gji -n '__fish_seen_subcommand_from open' -l workspace -d 'generate a .code-workspace file before opening (VS Code / Cursor / Windsurf)'
 complete -c gji -n '__fish_seen_subcommand_from open' -a '(__gji_worktree_branches)' -d 'worktree branch'
@@ -516,7 +518,7 @@ fi
 
 case "\${words[2]}" in
   new)
-    _arguments '--detached[create a detached worktree without a branch]' '--force[remove and recreate the worktree if the target path already exists]' '--open[open the new worktree in an editor after creation]' '--editor[editor CLI to use with --open (code, cursor, zed, …)]:editor:' '--dry-run[show what would be created without executing any git commands or writing files]' '--json[emit JSON on success or error instead of human-readable output]' '2:branch: '
+    _arguments '--detached[create a detached worktree without a branch]' '--from-current[base the new branch on the current worktree instead of the main worktree]' '--force[remove and recreate the worktree if the target path already exists]' '--open[open the new worktree in an editor after creation]' '--editor[editor CLI to use with --open (code, cursor, zed, …)]:editor:' '--dry-run[show what would be created without executing any git commands or writing files]' '--json[emit JSON on success or error instead of human-readable output]' '2:branch: '
     ;;
   init)
     _arguments '--write[write the integration to the shell config file]' '--json[emit a JSON error in non-interactive mode]' '2:shell:(${shells})'
@@ -547,7 +549,7 @@ case "\${words[2]}" in
     _arguments '--json[print history as JSON]'
     ;;
   open)
-    _arguments '--editor[editor CLI to use (code, cursor, zed, windsurf, subl, …)]:editor:' '--save[save the chosen editor to global config]' '--workspace[generate a .code-workspace file before opening (VS Code / Cursor / Windsurf)]' '2:branch:->worktrees'
+    _arguments '--editor[editor CLI to use (code, cursor, zed, windsurf, subl, …)]:editor:' '--select[choose a worktree with the interactive selector]' '--save[save the chosen editor to global config]' '--workspace[generate a .code-workspace file before opening (VS Code / Cursor / Windsurf)]' '2:branch:->worktrees'
     ;;
   go|jump)
     _arguments '--print[print the resolved worktree path explicitly]' '2:branch:->worktrees'

package/man/man1/gji-back.1

@@ -1,4 +1,4 @@
-.TH GJI\-BACK 1 "July 2026" "gji 0.9.0" "User Commands"
+.TH GJI\-BACK 1 "July 2026" "gji 0.10.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 "July 2026" "gji 0.9.0" "User Commands"
+.TH GJI\-CLEAN 1 "July 2026" "gji 0.10.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 "July 2026" "gji 0.9.0" "User Commands"
+.TH GJI\-COMPLETION 1 "July 2026" "gji 0.10.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 "July 2026" "gji 0.9.0" "User Commands"
+.TH GJI\-CONFIG 1 "July 2026" "gji 0.10.0" "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.9.0" "User Commands"
+.TH GJI\-DOCTOR 1 "July 2026" "gji 0.10.0" "User Commands"
 .SH NAME
 gji\-doctor \- check gji installation and configuration health
 .SH SYNOPSIS

package/man/man1/gji-go.1

@@ -1,4 +1,4 @@
-.TH GJI\-GO 1 "July 2026" "gji 0.9.0" "User Commands"
+.TH GJI\-GO 1 "July 2026" "gji 0.10.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 "July 2026" "gji 0.9.0" "User Commands"
+.TH GJI\-HISTORY 1 "July 2026" "gji 0.10.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 "July 2026" "gji 0.9.0" "User Commands"
+.TH GJI\-INIT 1 "July 2026" "gji 0.10.0" "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.9.0" "User Commands"
+.TH GJI\-LS 1 "July 2026" "gji 0.10.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 "July 2026" "gji 0.9.0" "User Commands"
+.TH GJI\-NEW 1 "July 2026" "gji 0.10.0" "User Commands"
 .SH NAME
 gji\-new \- create a new branch or detached linked worktree
 .SH SYNOPSIS
@@ -13,6 +13,9 @@ remove and recreate the worktree if the target path already exists
 .B \-\-detached
 create a detached worktree without a branch
 .TP
+.B \-\-from\-current
+base the new branch on the current worktree instead of the main worktree (cannot be combined with \-\-detached)
+.TP
 .B \-\-open
 open the new worktree in an editor after creation
 .TP

package/man/man1/gji-open.1

@@ -1,4 +1,4 @@
-.TH GJI\-OPEN 1 "July 2026" "gji 0.9.0" "User Commands"
+.TH GJI\-OPEN 1 "July 2026" "gji 0.10.0" "User Commands"
 .SH NAME
 gji\-open \- open the worktree in an editor
 .SH SYNOPSIS
@@ -7,6 +7,9 @@ gji\-open \- open the worktree in an editor
 open the worktree in an editor
 .SH OPTIONS
 .TP
+.B \-\-select
+choose a worktree with the interactive selector
+.TP
 .B \-\-editor <cli>
 editor CLI to use (code, cursor, zed, windsurf, subl, …)
 .TP

package/man/man1/gji-pr.1

@@ -1,4 +1,4 @@
-.TH GJI\-PR 1 "July 2026" "gji 0.9.0" "User Commands"
+.TH GJI\-PR 1 "July 2026" "gji 0.10.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 "July 2026" "gji 0.9.0" "User Commands"
+.TH GJI\-REMOVE 1 "July 2026" "gji 0.10.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 "July 2026" "gji 0.9.0" "User Commands"
+.TH GJI\-ROOT 1 "July 2026" "gji 0.10.0" "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.9.0" "User Commands"
+.TH GJI\-RUN\-HOOK 1 "July 2026" "gji 0.10.0" "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.9.0" "User Commands"
+.TH GJI\-STATUS 1 "July 2026" "gji 0.10.0" "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.9.0" "User Commands"
+.TH GJI\-SYNC\-FILES 1 "July 2026" "gji 0.10.0" "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.9.0" "User Commands"
+.TH GJI\-SYNC 1 "July 2026" "gji 0.10.0" "User Commands"
 .SH NAME
 gji\-sync \- fetch and update one or all worktrees
 .SH SYNOPSIS

package/man/man1/gji-warp.1

@@ -1,4 +1,4 @@
-.TH GJI\-WARP 1 "July 2026" "gji 0.9.0" "User Commands"
+.TH GJI\-WARP 1 "July 2026" "gji 0.10.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 "July 2026" "gji 0.9.0" "User Commands"
+.TH GJI 1 "July 2026" "gji 0.10.0" "User Commands"
 .SH NAME
 gji \- Context switching without the mess.
 .SH SYNOPSIS

package/package.json

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