uloop-launch

A command for opening or restarting the Unity Editor with the correct version for a project. Unity Editor is the application used to build and run Unity games.

In plain words
What is it for?
Launching a project, restarting a running Unity Editor, selecting a build platform, or adding a project to Unity Hub without launching it.
Why use it?
It removes the manual work of finding the project, choosing its Unity version, and waiting for the editor to become ready for commands.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/hatayama/unity-cli-loop/uloop-launch
Any agent
npx skills add hatayama/unity-cli-loop --skill uloop-launch
Clone the repo
git clone --depth 1 https://github.com/hatayama/unity-cli-loop

Made for: Claude Code, Codex.

Per session 46 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 704 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00046 $0.00704
Opus 5 $0.00023 $0.00352
Sonnet 5 $0.00009 $0.00141
Haiku 4.5 $0.00005 $0.00070

Measured yesterday against content hash bfeca9e6676e, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

uloop-launch scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/uloop-launch/SKILL.md · 63 lines

How it starts

The opening of the file, as written. The whole thing — 63 lines — stays where its author put it; the contents beside it link to each section on GitHub.

uloop launch

Launch Unity Editor with the correct version for a project.

uloop launch is not fire-and-forget. When Unity needs to start or restart, the command waits until Unity is actually ready for CLI operations before it exits.

Usage

uloop launch [project-path] [options]

Parameters

Parameter Type Description
project-path string Optional. Use only when the target Unity project is not in the current directory.
-r, --restart flag Kill running Unity and restart
-q, --quit flag Kill an existing Unity process for the project without launching
--editor-version <version> string Use this Unity Editor version instead of ProjectVersion.txt
-p, --platform <P> string Build target (e.g., StandaloneOSX, Android, iOS)
--max-depth <N> number Search depth when project-path is omitted (default: 3, -1 for unlimited)

Output

May print status/progress lines before the final JSON payload, such as project path, detected Unity version, or readiness wait messages.

The final JSON payload includes:

  • Success: whether the command completed
  • Ready: whether Unity CLI Loop is ready for commands
  • ServerReady: whether the Unity CLI Loop server accepted requests
  • ProjectIpcReady: whether the project IPC path accepted tool requests
  • AlreadyRunning: whether an existing Unity process was reused
  • Launched: whether this command launched a Unity process
  • Restarted: whether this command stopped an existing process and launched a new one
  • Quit: whether this command stopped Unity without launching a new process
  • PreviousProcessId: process ID stopped by restart or quit, when available
  • CurrentProcessId: current Unity process ID, when available
  • ProjectRoot: resolved project root
  • Message: readiness summary

When not to use

A single failed, cancelled, or busy command (e.g. right after a domain reload) is not a reason to launch — retry the command instead. Running launch while the Editor is up brings the Unity window to the foreground, which disrupts the user. Reach for launch only when Unity is not running, or still does not respond after retries.

Read the full file on GitHub · 63 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday Changed · +8 lines · +29 tokens per session bfeca9e6676e
  2. yesterday First seen · 55 lines · 17 tokens per session scan A c7b978963dd0

Subscribe to this mod's changes

uloop-launch is a skill published in the GitHub repository hatayama/unity-cli-loop (522 stars, last pushed yesterday), licensed MIT. It adds 46 tokens to every session and 704 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

unity

Compile, test, and drive Unity for this repo's C# packages (unity/core, jint, quickjs, clearscript) and the two Unity projects (tests/, kitchen-sink/). Use when a change touches C# under unity/, when Unity test results are needed, when a rendering snapshot has to be checked or regenerated, or when the app has to be…

ReactUnity/core · 108 tokens

test-designing-guide

Provides test design methodology for Unity projects. Use this skill whenever designing test cases from requirements or specifications, including selecting test techniques, deriving test cases, and formatting them. Even for small features, load this skill to ensure test design rigor.

nowsprinting/unity-coding-skills · 52 tokens

fix-bug

Diagnoses and fixes bugs using a test-first workflow (reproduce, diagnose, fix). Use this skill whenever the user reports a bug, describes unexpected behavior, or asks to investigate or fix a defect. Even if the user says "something's broken", "this isn't working", "fix this bug", or "why does X happen", load this…

nowsprinting/unity-coding-skills · 86 tokens

plan-feature

Orchestrates the test-first implementation planning workflow for feature implementation and spec changes. Use this skill whenever plan mode is active and the task involves implementing or adding a new feature, or changing an existing specification. Even if the user only says "plan this" or "how should we implement…

nowsprinting/unity-coding-skills · 76 tokens

refine-tests

Reviews existing test code for conformance to the test-designing-guide and test-writing-guide, then applies the refinements. Use this skill when the user wants to review or refine existing test code so it follows the project's test design and writing conventions. Typically invoked as /refine-tests .

nowsprinting/unity-coding-skills · 64 tokens

test-writing-guide

Provides guidelines for writing test code for Unity projects. Make sure to use this skill whenever writing, creating, editing, or modifying test code files (files under Tests/). This includes implementing new tests, fixing test failures, adding test cases, or any task that results in test code changes. Even for small…

nowsprinting/unity-coding-skills · 81 tokens