Skip to content

Unity Bridge Script

Cross-platform Unity Editor integration script providing HTTP API access for Claude Code workflows.

Features

  • Unity Editor Integration: Communicate with Unity Editor via HTTP API
  • Cross-Platform Support: Works on Linux and Windows (WSL compatible)
  • Health Monitoring: Check Unity Editor server status
  • Project Management: Compile, build, and manage Unity projects
  • Log Retrieval: Access Unity console logs and compilation results
  • WSL Detection: Automatic Windows curl usage in WSL environments

Available Commands

Server Management

  • health - Check Unity Bridge server status
  • compile - Trigger Unity project compilation
  • logs - Retrieve Unity console logs and compilation status

API Configuration

  • Default URL: http://localhost:5556
  • Timeout: 300 seconds (5 minutes)
  • Protocol: HTTP with JSON content type

Usage Examples

# Check Unity server health
./docs/actions/unity-bridge-actions.sh health

# Compile Unity project
./docs/actions/unity-bridge-actions.sh compile

# Get Unity logs
./docs/actions/unity-bridge-actions.sh logs

Unity Bridge Workflow

  1. Health Check: Verify Unity Editor is running and accessible
  2. Compilation: Trigger project build and compilation
  3. Log Review: Check for errors and compilation status
  4. Error Resolution: Fix issues and repeat until clean compilation

File Location

  • Unity Bridge Script: docs/actions/unity-bridge-actions.sh

Requirements

  • Unity Editor with Unity Bridge plugin installed
  • Unity Bridge server running on port 5556
  • curl utility for HTTP requests
  • For WSL: Windows curl accessible via cmd.exe

WSL Support

Automatically detects WSL environment and uses Windows curl for proper Unity communication across the Windows/Linux boundary.