UnityHub CLI

日本語版はこちら / Japanese version

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.

Requirements

• macOS or Windows 10/11
• Node.js 20+

Installation & Run

npx unity-hub-cli

Or install globally to use the unity-hub-cli command directly:

npm install -g unity-hub-cli
unity-hub-cli

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:

• winpty cmd.exe /c npx unity-hub-cli
• winpty powershell.exe -NoProfile -Command npx unity-hub-cli

Controls

| 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 |

In settings panels, use j/k to navigate, Space to toggle, and Esc to close.

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.

CLI Options

• --no-git-root-name: Display Unity project titles instead of Git repository root folder names.

Security

This project implements supply chain attack prevention measures:

• ignore-scripts: Disables automatic script execution during npm install
• Dependabot: Automated weekly security updates
• Security audit CI: Runs npm audit and lockfile-lint on every PR
• Pinned versions: All dependencies use exact versions (no ^ or ~)

License

MIT