explaingit

codeturion/unity-headless-cli-skill

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A Claude Code plugin that configures a Unity project for headless, terminal driven control over SSH, no editor GUI required.

Mindmap

mindmap
  root((repo))
    What it does
      Headless Unity control
      Terminal commands
    Tech stack
      Python
      Unity CLI
      com.unity.pipeline
    Features
      One shot bootstrap
      CLAUDE.md wiring
      Standalone install script
    Security
      Localhost only
      Bearer token
    Audience
      Unity developers
      Claude Code users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let an AI coding assistant create GameObjects and edit a Unity project without opening the editor GUI.

USE CASE 2

Run a Unity editor headless over SSH on a remote build machine for CI or agent driven workflows.

USE CASE 3

Evaluate live C# code inside a running Unity project directly from a terminal command.

What is it built with?

PythonUnitySDL2

How does it compare?

codeturion/unity-headless-cli-skill0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a running -batchmode Unity editor left open, the CLI itself is still beta.

In plain English

This project is a plugin for Claude Code, the AI coding assistant, that sets up a Unity game project so it can be controlled entirely from a terminal, without opening Unity's normal graphical editor window. That matters for anyone using an AI assistant to build or test a Unity game, since the AI can then create objects, add components, edit assets, run tests, and execute C# code directly, without a person clicking through menus. It works on top of an existing experimental Unity feature called the pipeline package, which lets a running but windowless Unity editor accept text commands over a local connection. Installing the plugin adds that package to your project, writes a reference document describing the available commands, and updates the project's CLAUDE.md file so future Claude Code sessions automatically know how to use it. Every step it takes can be run again safely without causing problems. The underlying command tool can also be used on its own, outside of Claude Code, through a standalone install script and a set of terminal commands for creating objects or running arbitrary code inside the editor. Round trips between issuing a command and getting a result take around 200 to 600 milliseconds, and no project recompile is needed between commands, which the author positions as a lighter weight alternative to running a full graphical Unity editor over a remote desktop connection. For safety, the underlying server only accepts connections from the same machine and requires a security token that Unity generates for the project, so remote use has to go through a trusted SSH connection rather than being exposed directly to the internet. The project acknowledges that Unity publishes its own official skill covering the same command line tool, and describes itself as an additional setup layer on top of that official reference rather than a replacement for it. It is labeled experimental and still under active development.

Copy-paste prompts

Prompt 1
Help me install the unity-headless-cli-skill plugin and set up my Unity project for headless control.
Prompt 2
Explain how to launch a batchmode Unity editor and connect to it with unity command eval.
Prompt 3
Walk me through writing a custom CliCommand so I can extend the headless Unity command set.
Prompt 4
Summarize the security model for the pipeline server's bearer token and localhost binding.

Frequently asked questions

What is unity-headless-cli-skill?

A Claude Code plugin that configures a Unity project for headless, terminal driven control over SSH, no editor GUI required.

What language is unity-headless-cli-skill written in?

Mainly Python. The stack also includes Python, Unity, SDL2.

How hard is unity-headless-cli-skill to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is unity-headless-cli-skill for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.