unity-cli Skill for Claude Code: Control Unity Editors, Projects and Builds

Lets Claude Code run Unity's official command line tool: install Editors, create projects, build and test, and edit an open Editor.

Installs: 9.2K; on skills.sh
Stars: 1.2K; on GitHub
Files: 14; besides SKILL.md
Updated: Oct 2026; last repo commit

unity-cli makes the agent use the unity command line tool from Unity Technologies. If a Unity Editor is open it checks unity status and edits the live scene through the project's Pipeline package. Otherwise it installs Editors, creates projects, builds and runs tests.

It triggers when you ask to install or manage Editors, licenses or projects, set up version control, build, test, configure the Unity MCP server, or run any unity command. It needs the Unity CLI, which it installs if missing, and the 15-file folder holds 12 reference files, a CHANGELOG and a SECURITY file. It bundles no scripts.

Good for

Unity developers who want the agent to edit scenes and assets in the live Editor
Teams scripting Unity builds, tests and licenses in CI
People setting up a new Unity project, with Git or Unity Version Control, from the terminal

Install unity-cli

Claude Code

Copy this prompt.

Install the unity-cli skill in Claude Code. Run this command:

/plugin marketplace add Unity-Technologies/unity-agent-plugin
/plugin install unity@unity-agent-plugin

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

The plugin ships 33 skills including unity-cli and has no hooks or MCP server in its files. The skills CLI route installs only this skill. Either way the skill needs the Unity CLI; if unity is not found the skill installs it with Unity's install script (curl on macOS and Linux, PowerShell on Windows). Driving a live Editor also needs Unity 6.0+ and unity pipeline install in the project.

From the project README. Source.

What's in the skill

When it loads

Controls the Unity Editor and projects from the command line, driving a running Editor to edit scenes and assets or run C#. Use when asked to install or manage Editors, licenses, or projects, set up version control, build, test, configure the Unity MCP server, or run any unity command.

Sections in SKILL.md

Find a command: search, don't grep help
Drive a running Unity Editor (if one is open)
More than one Editor open? Pass --project-path
Install the CLI (if not already installed)
Global flags
Environment variables
Getting help
Exit codes
Commands
Common workflows
Inspect and run cloud builds and Pipeline Automation jobs
Edit a scene, GameObject, or asset — unity status first
Generate an asset, texture, sprite, image, or 3D model: check for the ai catalog plugin
Bootstrap a new project from scratch
Find and install a missing editor
Open a project with the correct editor

Key facts

Author: Unity Technologies (vendor's own repo; maintained by Unity, per the repo README)
License: Unity Companion License (LICENSE.md); skill frontmatter states none
Installs on skills.sh: 9,176 (Nov 2, 2026)
GitHub stars: 1,197 for the Unity-Technologies/skills repo (Nov 2, 2026)
Last commit: Oct 30, 2026
Files: 15 files including SKILL.md: 12 reference files, CHANGELOG.md and SECURITY.md; no scripts
Works in: Claude Code, GitHub Copilot, Cursor, Cline and 50+ other agents
Needs: The Unity CLI; Unity 6.0+ and the com.unity.pipeline package to drive a live Editor

What it includes

Searches the CLI itself with `unity commands --grep` or `unity command --query`
SKILL.md says never to grep `--help` output. The search covers built-in commands, the plugin catalog and the commands of a connected Editor.
Runs code · Find a command
Runs `unity status` and `unity command` to edit scenes and assets live
If a Unity Editor is open, the agent uses the project's Pipeline package to create GameObjects, edit scenes and assets, read the hierarchy and enter Play mode instead of hand-editing files.
Try: “Add a GameObject named Joe to the active scene”
Runs code · Drive a running Editor
`unity command script eval` runs arbitrary C# in the open Editor
Available when the Editor exposes script eval. SECURITY.md says it runs on your machine as your user.
Runs code · Run C# in the Editor
Installs the CLI with Unity's install script if `unity` is not found
The SKILL.md gives a curl install script for macOS and Linux and a PowerShell one for Windows, then asks for a new shell and `unity --version`.
Runs code · Install the Unity CLI
`unity install`, `editors`, `releases` pick and install an Editor with modules
Example: `unity install lts --module android --module ios --yes --accept-eula`. SKILL.md says --accept-eula is the user's acceptance, never the agent's.
Try: “Install Unity 6000.0.47f1 with the Android module”
Runs code · Install and manage Editors
`unity projects create`, `templates`, `open` set up a project and its Editor
Walks through choosing an Editor, a template (URP by default), adding the Pipeline package, opening the project and waiting until the Editor is ready.
Runs code · Create and open projects
`unity build`, `run` and `test` for CI-style builds and test runs
Includes JUnit or NUnit reports, exit codes that tell a failed test (8) from an infrastructure failure, and `--allow-install`.
Runs code · Build, run and test
`unity auth` and `unity license` log in and activate or return seats
CI can use a license serial or a service account kept in environment variables.
Runs code · Sign in and licenses
`unity pipeline cloud-build` and `pipeline automation` inspect and start jobs
Inventory commands are read-only per SKILL.md. Others start or cancel builds, download artifacts and trigger pipelines; some ask before acting unless --yes is passed.
Runs code · Cloud builds and automation
`unity vcs` and `unity uvcs` for Git, Git LFS and Unity Version Control
Covers project creation with a GitHub, GitLab or UVCS remote, status, sync, conflicts, diffs and locks.
Runs code · Version control
`unity mcp`, `unity setup` and `unity skill install` wire up AI clients
Configures the Unity MCP server, installs Unity's agent plugin, or copies skill files into a client. SKILL.md says to run these only when the user agrees.
Runs code · Connect agents and MCP
Looks for the `ai` catalog plugin before generating textures or models
If it is missing, the agent must ask before `unity plugin install ai`. SKILL.md says the plugin is alpha and limited to Unity staff.
Runs code · Check the AI Generators plugin
`unity doctor`, `unity logs` and `unity status` explain failures such as Safe Mode
SKILL.md says to tell you about timeouts and lifecycle failures and not to retry in a loop. `unity bug` sends logs to Unity, so the agent must ask first.
Runs code · Diagnose problems

From the official docs

Permissions

High risk

The skill can run C# in your open Unity Editor, install Editors, sign in to Unity and start cloud builds, so it works like a shell. Keep approvals on, and never let it pass --yes or --accept-eula without your say-so.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can run C# inside your open Unity Editor
`unity command script eval` runs arbitrary C# in the Editor as your user. SECURITY.md says to feed it trusted input only, never text assembled from third-party content. github.com
It pipes Unity's install script into a shell
If `unity` is missing, SKILL.md runs `curl -fsSL https://unity.com/install.sh | bash` (macOS and Linux) or `irm https://unity.com/install.ps1 | iex` (Windows). SECURITY.md says the installer checks a SHA-256 pin first. github.com
It can sign in, activate licenses and start cloud builds
Commands cover `auth login`, `license activate`, and starting or cancelling builds and pipelines. SKILL.md says `builds cancel`, `jobs terminate` and `jobs reject` ask first unless --yes is given. github.com
It changes your project and AI client setup
`unity pipeline install` adds the Pipeline package to your project. `unity skill install` and `unity setup` write skill files or plugins into AI client settings; SECURITY.md says they run only when the user runs them. github.com
It sends crash reports and a usage ping
SKILL.md says the CLI reports anonymous crashes via Sentry and sends one anonymous usage ping per run. UNITY_NO_CRASH_REPORT, UNITY_NO_CLI_INVOKED_TELEMETRY or DO_NOT_TRACK turn these off. github.com
`unity bug` sends logs to Unity
SKILL.md says the agent must ask first and never run it on its own initiative. github.com

Technical details

Talks to	unity.com
Scopes	Shell commands: unity CLI, curl, git Local Unity Editor and project files Unity account sign-in and licenses Unity Cloud builds and pipelines

Questions

What does the unity-cli skill do?

It teaches the agent to use Unity's own unity command line tool. With it the agent can install Editors, create and open projects, build and test, and control an open Editor to edit scenes and assets.

How do I install unity-cli in Claude Code?

Use the install box above. Unity's README tells Claude Code and Codex users to install the official Unity plugin, which ships these skills together. The skills CLI installs only this skill, and the skill then installs the Unity CLI itself when it is missing.

Is unity-cli official?

Yes. It lives in Unity Technologies' own skills repo, and the README says Unity maintains and publishes it. The Unity plugin for Claude Code is listed in Anthropic's official marketplace according to the CLI's SECURITY.md.

Does it work in the Claude app or Claude.ai?

We do not list a Claude app route. The skill runs the unity command line tool on your machine, so it needs an agent that can run commands.

Does it need a Unity license or sign-in?

The skill's bootstrap steps check unity auth status and unity license status, and say to sign in and activate a license when none is active. CI can use a license serial or service account kept in environment variables. The skill does not state pricing.

Is unity-cli safe?

It can run C# inside your open Editor, install software, sign in to Unity and start cloud builds, so treat it like a shell. SECURITY.md describes safeguards: local-only Editor control, a pinned download for skills, and user-run commands only. It also sends crash reports and a usage ping that you can turn off.

What is the difference between unity-cli and unity-pipeline?

unity-cli documents the unity command line tool. SKILL.md says the Pipeline package ships a deeper unity-pipeline skill, which you mirror next to it with unity skill install <client> --local.

What if the agent cannot connect to my Editor?

SKILL.md says to check Safe Mode first, since compile errors stop the Pipeline package loading, and a sandboxed agent shell can hide a running Editor. It says to tell you about timeouts and not to hand-edit scene files as a quiet fallback.

Information

updated Nov 2, 2026

Repository: unity-technologies/skills
Folder: skills/unity-cli

unity-technologies/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

github.com · github.com
github.com · github.com
github.com · github.com
github.com · github.com