unity-hub-cli 0.16.0 → 0.18.0

package/README.md

@@ -4,104 +4,108 @@
 
 A CLI tool that displays the same content as Unity Hub in an Ink-based TUI, allows navigation with arrow keys/`j`/`k`, and launches Unity Editor by pressing `o`.
 
-<img width="1678" height="1460" alt="スクリーンショット 2025-10-27 23 44 40" src="https://github.com/user-attachments/assets/db3cc995-820e-490b-a43b-393893197ab4" />
+<img width="1678" height="1460" alt="Screenshot 2025-10-27 23 44 40" src="https://github.com/user-attachments/assets/db3cc995-820e-490b-a43b-393893197ab4" />
 
 ## Requirements
 
 - macOS or Windows 10/11
 - Node.js 20+
-- Unity Hub
-  - macOS: `~/Library/Application Support/UnityHub/projects-v1.json`
-  - Windows: `%APPDATA%\UnityHub\projects-v1.json`
-  - Windows Editor path (default): `C:\\Program Files\\Unity\\Hub\\Editor\\<version>\\Editor\\Unity.exe`
 
-## Usage
-
-### Development
+## Installation & Run
 
 ```bash
-npm install
-npm run dev
+npx unity-hub-cli
 ```
 
-### Build
+Or install globally to use the `unity-hub-cli` command directly:
 
 ```bash
-npm run build
+npm install -g unity-hub-cli
+unity-hub-cli
 ```
 
-### Run
-
-After building, `dist/index.js` will be generated. You can also run it directly via npx.
+<details>
+<summary>Notes for Windows</summary>
 
-```bash
-npx unity-hub-cli
-# or
-node dist/index.js
-```
+Works from PowerShell and CMD. Git Bash is supported when running inside a ConPTY-based terminal (Windows Terminal or VS Code/Cursor integrated terminal).
 
-On Windows, it works from PowerShell and CMD. Git Bash is supported when running inside a ConPTY-based terminal (Windows Terminal or VS Code/Cursor integrated terminal). On standalone Git Bash (MinTTY), raw mode is not supported; use PowerShell/CMD/Windows Terminal. If you must use MinTTY Git Bash, run one of the following:
+On standalone Git Bash (MinTTY), raw mode is not supported; use PowerShell/CMD/Windows Terminal. If you must use MinTTY Git Bash, run one of the following:
 
 - `winpty cmd.exe /c npx unity-hub-cli`
 - `winpty powershell.exe -NoProfile -Command npx unity-hub-cli`
-- If already built: `npm run build && winpty node dist/index.js`
 
-See `https://github.com/vadimdemedes/ink/#israwmodesupported`.
+</details>
 
-By default, the project list uses the Git repository root folder name when available.
+## Controls
 
-### CLI Options
+| Key | Action |
+|-----|--------|
+| `↑` / `↓` / `j` / `k` | Navigate selection |
+| `o` | Launch selected project in Unity |
+| `O` (Shift+O) | Launch Unity + external editor (e.g., Rider) |
+| `i` | Launch external editor only |
+| `q` | Quit Unity for selected project |
+| `r` | Refresh project list |
+| `c` | Copy project path to clipboard |
+| `s` | Open sort settings panel |
+| `v` | Open visibility settings panel |
+| `Ctrl + C` | Exit |
 
-- `--no-git-root-name`: Display Unity project titles instead of Git repository root folder names.
-- `--hide-branch`: Hide the Git branch column.
-- `--hide-path`: Hide the project path column.
+In settings panels, use `j`/`k` to navigate, `Space` to toggle, and `Esc` to close.
 
-## Release Automation
+The display includes Git branch (if present), Unity version, project path, and last modified time. By default, the project list uses the Git repository root folder name when available.
 
-Version and release management is automated using release-please and GitHub Actions.
+## CLI Options
 
-- `.github/workflows/release-please.yml` runs on push to `main` or manual trigger
-- The action references `release-please-config.json` and `.release-please-manifest.json` to create release PRs and tags
-- When a PR is merged, GitHub Releases and changelog are automatically updated
-- **npm publish is automated with provenance** for supply chain security
+- `--no-git-root-name`: Display Unity project titles instead of Git repository root folder names.
+- `--shell-init`: Install shell function for automatic `cd` integration (with confirmation prompt).
+- `--shell-init --dry-run`: Preview the shell function without installing.
 
-### Initial Setup Notes
+## Shell Integration
 
-- If existing releases are present, set the latest release commit in `bootstrap-sha` of `release-please-config.json`
-- The workflow uses GitHub's `GITHUB_TOKEN` and operates with `contents`/`pull-requests` permissions
+You can add a shell function to automatically `cd` to the project directory after opening Unity.
 
-### Manual Execution
+### Setup
 
-You can manually trigger the `release-please` workflow from the Actions tab by selecting `Run workflow`
+1. Install globally:
+```bash
+npm install -g unity-hub-cli
+```
 
-## Security
+2. Run the shell init command (auto-detects your shell):
+```bash
+unity-hub-cli --shell-init
+```
 
-This package implements multiple security measures to protect against supply chain attacks:
+This automatically adds the `unity-hub` function to your shell config file (`.zshrc`, `.bashrc`, `config.fish`, or PowerShell profile).
 
-1. **Automated Publishing with Provenance**: All npm releases are published via GitHub Actions with `--provenance` flag, providing cryptographic proof of the build environment
-2. **Minimal Dependencies**: Only 2 runtime dependencies (`ink` and `react`), both from highly trusted sources
-3. **Locked Dependencies**: `package-lock.json` is committed to ensure reproducible builds
-4. **Regular Security Audits**: Dependencies are regularly checked with `npm audit`
+3. Reload your shell:
+```bash
+source ~/.zshrc  # or restart your terminal
+```
 
-### Verifying Package Authenticity
+### Usage
 
-You can verify the authenticity of published packages:
+Now you can use `unity-hub` to:
+1. Browse and select Unity projects
+2. Press `o` to launch Unity
+3. Your terminal automatically `cd`s to the project directory
 
-```bash
-# Check provenance information
-npm view unity-hub-cli --json | jq .dist.attestations
+### Notes
 
-# Verify package integrity
-npm audit signatures
-```
+- Running `--shell-init` multiple times is safe - it updates the existing function using marker comments
+- The function uses absolute paths detected from your environment
+- **Windows**: Shell integration supports PowerShell only. CMD is not supported because it lacks shell functions required for automatic `cd` after launching Unity
 
-## Controls
+## Security
 
-- Arrow keys / `j` / `k`: Navigate selection
-- `o`: Launch selected project in Unity
-- Ctrl + C (twice): Exit
+This project implements supply chain attack prevention measures:
 
-The display includes Git branch (if present), Unity version, project path, and last modified time (`lastModified`).
+- **ignore-scripts**: Disables automatic script execution during `npm install`
+- **@lavamoat/allow-scripts**: Explicitly controls which packages can run install scripts
+- **Dependabot**: Automated weekly security updates
+- **Security audit CI**: Runs `npm audit`, `lockfile-lint`, and OSV-Scanner on every PR
+- **Pinned versions**: All dependencies use exact versions (no `^` or `~`)
 
 ## License
 

package/dist/index.js

@@ -1,7 +1,13 @@
 #!/usr/bin/env node
 
 // src/index.tsx
+import { execSync } from "child_process";
+import { existsSync as existsSync3, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { dirname as dirname2, join as join9 } from "path";
 import process3 from "process";
+import { createInterface as createInterface2 } from "readline";
+import chalk from "chalk";
 import { render } from "ink";
 
 // src/application/usecases.ts
@@ -1332,7 +1338,7 @@ var WinUnityProcessTerminator = class {
         ],
         { env: getMsysDisabledEnv() }
       );
-    } catch (error) {
+    } catch {
       if (!ensureProcessAlive2(unityProcess.pid)) {
         return { terminated: true, stage: "sigterm" };
       }
@@ -1358,7 +1364,7 @@ var WinUnityProcessTerminator = class {
         ],
         { env: getMsysDisabledEnv() }
       );
-    } catch (error) {
+    } catch {
       if (!ensureProcessAlive2(unityProcess.pid)) {
         return { terminated: true, stage: "sigkill" };
       }
@@ -1999,7 +2005,9 @@ var App = ({
   onLaunchEditorOnly,
   onTerminate,
   onRefresh,
-  useGitRootName = true
+  useGitRootName = true,
+  outputPathOnExit = false,
+  onSetExitPath
 }) => {
   const { exit } = useApp();
   const { stdout } = useStdout2();
@@ -2196,20 +2204,14 @@ var App = ({
       return;
     }
     const { project } = projectView;
-    try {
-      const cdTarget = getCopyTargetPath(projectView);
-      const command = buildCdCommand(cdTarget);
-      clipboard.writeSync(command);
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      setHint(`Failed to copy: ${message}`);
-      setTimeout(() => {
-        setHint(defaultHintMessage);
-      }, 3e3);
-      return;
-    }
+    const cdTarget = getCopyTargetPath(projectView);
     try {
       await onLaunch(project);
+      if (outputPathOnExit) {
+        onSetExitPath?.(cdTarget);
+        exit();
+        return;
+      }
       setLaunchedProjects((previous) => {
         const next = new Set(previous);
         next.add(project.id);
@@ -2229,6 +2231,11 @@ var App = ({
       }, 3e3);
     } catch (error) {
       if (error instanceof LaunchCancelledError) {
+        if (outputPathOnExit) {
+          onSetExitPath?.(cdTarget);
+          exit();
+          return;
+        }
         setHint("Launch cancelled");
         setTimeout(() => {
           setHint(defaultHintMessage);
@@ -2241,7 +2248,7 @@ var App = ({
         setHint(defaultHintMessage);
       }, 3e3);
     }
-  }, [index, onLaunch, sortedProjects]);
+  }, [exit, index, onLaunch, onSetExitPath, outputPathOnExit, sortedProjects]);
   const launchSelectedWithEditor = useCallback(async () => {
     if (!onLaunchWithEditor) {
       setHint("Launch with editor not available");
@@ -2259,20 +2266,14 @@ var App = ({
       return;
     }
     const { project } = projectView;
-    try {
-      const cdTarget = getCopyTargetPath(projectView);
-      const command = buildCdCommand(cdTarget);
-      clipboard.writeSync(command);
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      setHint(`Failed to copy: ${message}`);
-      setTimeout(() => {
-        setHint(defaultHintMessage);
-      }, 3e3);
-      return;
-    }
+    const cdTarget = getCopyTargetPath(projectView);
     try {
       const result = await onLaunchWithEditor(project);
+      if (outputPathOnExit) {
+        onSetExitPath?.(cdTarget);
+        exit();
+        return;
+      }
       setLaunchedProjects((previous) => {
         const next = new Set(previous);
         next.add(project.id);
@@ -2292,6 +2293,11 @@ var App = ({
       }, 3e3);
     } catch (error) {
       if (error instanceof LaunchCancelledError) {
+        if (outputPathOnExit) {
+          onSetExitPath?.(cdTarget);
+          exit();
+          return;
+        }
         setHint("Launch cancelled");
         setTimeout(() => {
           setHint(defaultHintMessage);
@@ -2304,7 +2310,7 @@ var App = ({
         setHint(defaultHintMessage);
       }, 3e3);
     }
-  }, [index, onLaunchWithEditor, sortedProjects]);
+  }, [exit, index, onLaunchWithEditor, onSetExitPath, outputPathOnExit, sortedProjects]);
   const launchEditorOnly = useCallback(async () => {
     if (!onLaunchEditorOnly) {
       setHint("Launch editor only not available");
@@ -2634,7 +2640,186 @@ var App = ({
 
 // src/index.tsx
 import { jsx as jsx7 } from "react/jsx-runtime";
+var SHELL_INIT_MARKER_START = "# >>> unity-hub-cli >>>";
+var SHELL_INIT_MARKER_END = "# <<< unity-hub-cli <<<";
+var getShellConfigPath = () => {
+  const shell = process3.env["SHELL"] ?? "";
+  const home = homedir();
+  if (shell.includes("zsh")) {
+    return join9(home, ".zshrc");
+  }
+  if (shell.includes("bash")) {
+    const bashrcPath = join9(home, ".bashrc");
+    const profilePath = join9(home, ".bash_profile");
+    return existsSync3(bashrcPath) ? bashrcPath : profilePath;
+  }
+  if (shell.includes("fish")) {
+    return join9(home, ".config", "fish", "config.fish");
+  }
+  if (process3.platform === "win32") {
+    return join9(home, "Documents", "WindowsPowerShell", "Microsoft.PowerShell_profile.ps1");
+  }
+  return void 0;
+};
+var getShellInitScriptWithMarkers = () => {
+  const script = getShellInitScript();
+  return `${SHELL_INIT_MARKER_START}
+${script}
+${SHELL_INIT_MARKER_END}`;
+};
+var askConfirmation = (question) => {
+  const rl = createInterface2({
+    input: process3.stdin,
+    output: process3.stdout
+  });
+  return new Promise((resolve4) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve4(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+    });
+  });
+};
+var previewShellInit = () => {
+  const configPath = getShellConfigPath();
+  console.log("=== Shell Integration Preview ===\n");
+  console.log(`Target file: ${configPath ?? "Unknown (unsupported shell)"}
+`);
+  console.log("Content to be added:\n");
+  console.log(getShellInitScriptWithMarkers());
+};
+var installShellInit = () => {
+  const configPath = getShellConfigPath();
+  if (!configPath) {
+    return { success: false, message: "Unsupported shell. Please copy the function from the README into your shell config manually." };
+  }
+  const scriptWithMarkers = getShellInitScriptWithMarkers();
+  const markerPattern = new RegExp(
+    `${SHELL_INIT_MARKER_START}[\\s\\S]*?${SHELL_INIT_MARKER_END}`,
+    "g"
+  );
+  let content = "";
+  if (existsSync3(configPath)) {
+    content = readFileSync(configPath, "utf-8");
+  }
+  const existingMatch = content.match(markerPattern);
+  if (existingMatch && existingMatch[0] === scriptWithMarkers) {
+    return { success: true, message: `Shell integration is already up to date in ${configPath}` };
+  }
+  let newContent;
+  let action;
+  if (existingMatch) {
+    newContent = content.replace(markerPattern, scriptWithMarkers);
+    action = "updated";
+  } else {
+    newContent = content.trimEnd() + "\n\n" + scriptWithMarkers + "\n";
+    action = "installed";
+  }
+  mkdirSync(dirname2(configPath), { recursive: true });
+  writeFileSync(configPath, newContent, "utf-8");
+  return { success: true, message: `Shell integration ${action} in ${configPath}` };
+};
+var getNodePath = () => {
+  const isWindows = process3.platform === "win32";
+  const command = isWindows ? "where node" : "which node";
+  try {
+    const result = execSync(command, { encoding: "utf-8" }).trim().split("\n")[0];
+    if (result && existsSync3(result)) {
+      return result;
+    }
+  } catch {
+  }
+  return "node";
+};
+var getUnityHubCliPath = () => {
+  const isWindows = process3.platform === "win32";
+  try {
+    const prefix = execSync("npm config get prefix", { encoding: "utf-8" }).trim();
+    const binDir = isWindows ? prefix : `${prefix}/bin`;
+    const cliPath = isWindows ? `${binDir}/unity-hub-cli.cmd` : `${binDir}/unity-hub-cli`;
+    if (existsSync3(cliPath)) {
+      return cliPath;
+    }
+  } catch {
+  }
+  return "unity-hub-cli";
+};
+var getShellInitScript = () => {
+  const shell = process3.env["SHELL"] ?? "";
+  const isWindows = process3.platform === "win32";
+  const nodePath = getNodePath();
+  const cliPath = getUnityHubCliPath();
+  if (shell.includes("fish")) {
+    return `function unity-hub
+  set -l tmpfile (mktemp)
+  ${nodePath} ${cliPath} --output-path-on-exit > $tmpfile
+  set -l dir (cat $tmpfile)
+  rm -f $tmpfile
+  if test -n "$dir"
+    cd $dir
+  end
+end`;
+  }
+  if (shell.includes("bash") || shell.includes("zsh")) {
+    return `unity-hub() {
+  local tmpfile=$(mktemp)
+  ${nodePath} ${cliPath} --output-path-on-exit >| "$tmpfile"
+  local dir=$(cat "$tmpfile")
+  rm -f "$tmpfile"
+  if [ -n "$dir" ]; then
+    cd "$dir"
+  fi
+}`;
+  }
+  if (isWindows) {
+    return `function unity-hub {
+  $tmpfile = [System.IO.Path]::GetTempFileName()
+  & "${cliPath}" --output-path-on-exit > $tmpfile
+  $dir = Get-Content $tmpfile
+  Remove-Item $tmpfile
+  if ($dir) {
+    Set-Location $dir
+  }
+}`;
+  }
+  return `unity-hub() {
+  local tmpfile=$(mktemp)
+  ${nodePath} ${cliPath} --output-path-on-exit >| "$tmpfile"
+  local dir=$(cat "$tmpfile")
+  rm -f "$tmpfile"
+  if [ -n "$dir" ]; then
+    cd "$dir"
+  fi
+}`;
+};
 var bootstrap = async () => {
+  const args = process3.argv.slice(2);
+  if (args.includes("--shell-init")) {
+    const isDryRun = args.includes("--dry-run");
+    if (isDryRun) {
+      previewShellInit();
+      return;
+    }
+    const configPath = getShellConfigPath();
+    if (!configPath) {
+      console.log("Unsupported shell. Please copy the function from the README into your shell config manually.");
+      process3.exitCode = 1;
+      return;
+    }
+    console.log(`This will install the unity-hub function to: ${configPath}
+`);
+    previewShellInit();
+    console.log("");
+    const confirmed = await askConfirmation("Proceed with installation? (y/n): ");
+    if (!confirmed) {
+      console.log("Installation cancelled.");
+      return;
+    }
+    const result = installShellInit();
+    console.log(result.message);
+    process3.exitCode = result.success ? 0 : 1;
+    return;
+  }
+  const outputPathOnExit = args.includes("--output-path-on-exit");
   const isWindows = process3.platform === "win32";
   const unityHubReader = isWindows ? new WinUnityHubProjectsReader() : new MacUnityHubProjectsReader();
   const gitRepositoryInfoReader = new GitRepositoryInfoReader();
@@ -2694,8 +2879,13 @@ var bootstrap = async () => {
       process3.exitCode = 1;
       return;
     }
+    if (outputPathOnExit && process3.stderr.isTTY) {
+      chalk.level = 3;
+    }
     const theme = await detectTerminalTheme();
+    let lastOpenedPath;
     const projects = await listProjectsUseCase.execute();
+    const renderOptions = outputPathOnExit ? { stdout: process3.stderr, stdin: process3.stdin } : void 0;
     const { waitUntilExit } = render(
       /* @__PURE__ */ jsx7(ThemeProvider, { theme, children: /* @__PURE__ */ jsx7(
         App,
@@ -2706,12 +2896,24 @@ var bootstrap = async () => {
           onLaunchEditorOnly: (project) => launchEditorOnlyUseCase.execute(project),
           onTerminate: (project) => terminateProjectUseCase.execute(project),
           onRefresh: () => listProjectsUseCase.execute(),
-          useGitRootName
+          useGitRootName,
+          outputPathOnExit,
+          onSetExitPath: (path) => {
+            lastOpenedPath = path;
+          }
         }
-      ) })
+      ) }),
+      renderOptions
     );
     await waitUntilExit();
-    process3.stdout.write("\x1B[2J\x1B[3J\x1B[H");
+    if (outputPathOnExit) {
+      process3.stderr.write("\x1B[2J\x1B[3J\x1B[H");
+      if (lastOpenedPath) {
+        process3.stdout.write(lastOpenedPath);
+      }
+    } else {
+      process3.stdout.write("\x1B[2J\x1B[3J\x1B[H");
+    }
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     console.error(message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unity-hub-cli",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "A CLI tool that reads Unity Hub's projects and launches Unity Editor with an interactive TUI",
   "main": "dist/index.js",
   "scripts": {
@@ -8,10 +8,11 @@
     "dev": "tsx src/index.ts",
     "build": "tsup",
     "start": "node dist/index.js",
-    "lint": "eslint . --ext .ts,.tsx",
-    "lint:fix": "eslint . --ext .ts,.tsx --fix",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
     "format": "prettier --write .",
-    "typecheck": "tsc -noEmit"
+    "typecheck": "tsc -noEmit",
+    "allow-scripts": "allow-scripts"
   },
   "repository": {
     "type": "git",
@@ -36,26 +37,38 @@
     "dist"
   ],
   "dependencies": {
-    "clipboardy": "^4.0.0",
-    "ink": "^4.4.1",
-    "react": "^18.3.1"
+    "chalk": "5.6.2",
+    "clipboardy": "5.0.1",
+    "ink": "6.5.1",
+    "react": "19.2.1"
   },
   "engines": {
     "node": ">=18"
   },
+  "lavamoat": {
+    "allowScripts": {
+      "eslint-import-resolver-typescript>unrs-resolver": false,
+      "tsup>bundle-require>esbuild": false,
+      "tsup>esbuild": false,
+      "tsx>esbuild": false
+    }
+  },
   "devDependencies": {
-    "@types/node": "^20.19.20",
-    "@types/react": "^18.3.26",
-    "@typescript-eslint/eslint-plugin": "^7.18.0",
-    "@typescript-eslint/parser": "^7.18.0",
-    "eslint": "^8.57.0",
-    "eslint-config-prettier": "^9.1.2",
-    "eslint-import-resolver-typescript": "^3.10.1",
-    "eslint-plugin-import": "^2.32.0",
-    "prettier": "^3.6.2",
-    "tsup": "^8.5.0",
-    "tsx": "^4.20.6",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.14"
+    "@eslint/js": "^9.39.1",
+    "@lavamoat/allow-scripts": "3.4.1",
+    "@types/node": "24.10.1",
+    "@types/react": "19.2.7",
+    "@typescript-eslint/eslint-plugin": "8.48.1",
+    "@typescript-eslint/parser": "8.48.1",
+    "eslint": "9.39.1",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-import-resolver-typescript": "4.4.4",
+    "eslint-plugin-import": "2.32.0",
+    "prettier": "3.7.3",
+    "tsup": "8.5.1",
+    "tsx": "4.21.0",
+    "typescript": "5.9.3",
+    "typescript-eslint": "^8.48.1",
+    "vitest": "4.0.15"
   }
 }