uloop-launch

Launch the Unity Editor version matching a project's required version.

500|44|Updated Jun 15, 2025
One-click install
npx skills add https://github.com/hatayama/unity-cli-loop --skill uloop-launch-hatayama
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uloop-launch
Source: https://github.com/hatayama/unity-cli-loop/tree/main/.agents/skills/uloop-launch
Command: npx skills add https://github.com/hatayama/unity-cli-loop --skill uloop-launch-hatayama

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Opening a Unity project with the wrong Editor version can cause crashes, asset reimports, or incompatible project settings; this Skill ensures the project opens with the correct Editor to avoid those issues.

Core Features & Use Cases

  • Detects and prints the Unity Editor version required by a project before launching.
  • Launches the Unity Editor that matches the project's version, focuses existing windows when Unity is running, or restarts Unity by killing and relaunching the process.
  • Supports switching build targets on launch, adding projects to Unity Hub without launching, favoriting projects in Hub, and configurable search depth when locating projects.
  • Use case: a developer needs to open a legacy project that requires Unity 2022.3.x and wants the CLI to find the installed Editor, restart the running Editor if necessary, and open the project on Android build target.

Quick Start

Run uloop launch in your project directory to open the project with the matching Unity Editor version.

Frequently Asked Questions about uloop-launch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I launch a Unity project with the correct Editor version from the command line?

To launch a Unity project with the correct Editor version, run the CLI command in your project directory. It detects the project's required version, locates the matching installed Unity Editor, and opens the project to prevent version mismatch errors.

Why does Unity crash or reimport assets when I open a project?

Unity crashes or reimports assets when opening a project due to an Editor version mismatch. Using a CLI tool to detect the project's required version and launch the matching Unity Editor prevents these incompatible settings and asset reimport issues.

Can I switch Unity build targets automatically when launching a project?

Yes, you can switch Unity build targets automatically when launching a project. The CLI supports platform selection on launch, allowing you to specify targets like Android or iOS while the matching Editor version opens the project.

How do I restart a running Unity Editor instance from the CLI?

To restart a running Unity Editor instance from the CLI, use the launch command which can kill existing Unity processes and relaunch them. It focuses existing windows if Unity is running or completely restarts the Editor process.

Does this Unity launcher work with Unity Hub for project registration?

Yes, this Unity launcher works with Unity Hub for project registration. You can add projects to Unity Hub without launching them, and even favorite projects in Hub, while ensuring the correct Editor version is detected and matched.

Can I use this Unity launch tool in CI and automation pipelines?

Yes, you can use this Unity launch tool in CI and automation pipelines. It supports automated scenarios for opening projects, restarting running Editor instances, switching build targets, and locating projects with configurable search depth.