Harness Unity Bridge

September 4, 2026 · View on GitHub

English | 中文

Unity 2021.3+ Python 3.8+

PyPI GitHub release CI

PyPI Downloads codecov License: Apache 2.0

File-based bridge enabling DeepSeek Harness to trigger Unity Editor operations in a running editor instance.

✨ Features

  • Run Tests — Execute EditMode or PlayMode tests
  • Compile — Trigger script compilation
  • Refresh — Force asset database refresh
  • Get Status — Check editor compilation/update state
  • Get Console Logs — Retrieve Unity console output
  • Play Mode Control — Play, pause, and step through frames
  • Build — Direct builds or custom build pipelines
  • Asset Dependency Analysis — Dependencies, references, unused assets, path tracing, search, and asset info
  • Prefab Management — Inspect prefab metadata and hierarchy, create prefabs from scene objects
  • Asset Inspector Dump — Dump Inspector-visible serialized field values of prefabs, assets, and scenes

🚀 Quick Start

1. Install

macOS / Linux / Git Bash:

curl -sSL https://raw.githubusercontent.com/WarrenMondeville/harness-unity-bridge/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/WarrenMondeville/harness-unity-bridge/main/install.ps1 | iex

2. Add to Your Unity Project(s)

In Unity: Window > Package Manager > + > Add package from git URL...

https://github.com/WarrenMondeville/harness-unity-bridge.git?path=package

3. Use It

Open DeepSeek Harness in your Unity project directory:

"Run the Unity tests"
"Check for compilation errors"
"Show me the error logs"

Or use the CLI directly:

harness-unity-bridge run-tests --mode EditMode
harness-unity-bridge compile
harness-unity-bridge get-console-logs --limit 10

Updating

harness-unity-bridge update

⚙️ How It Works

DeepSeek Harness → harness-unity-bridge CLI → .harness-unity-bridge/command.json → Unity Editor → response.json
  1. DeepSeek Harness (or you) runs harness-unity-bridge commands
  2. The CLI writes commands to .harness-unity-bridge/command.json
  3. Unity Editor polls and executes commands
  4. Results appear in .harness-unity-bridge/response-{id}.json

Each Unity project has its own .harness-unity-bridge/ directory, enabling multi-project support.

📚 Documentation