status.md
scenes · selection · consoleUNITY EDITOR PACKAGE Bridge 0.15.0
Give AI a durable way into Unity.
Alepou Unity Bridge turns the Editor into a structured, observable workspace an agent can work through for hours—not a fragile sequence of pasted commands and manual status checks.
Free and open source. Manual approval is the default; delegated autonomy is always an explicit, local, time-bounded choice.
Refresh assetsdomain reload survived
DONEWait for compile0 errors · 2 warnings
DONERun focused tests18 / 24 passed
RUNNINGBuild Android playerwaiting at approval boundary
WAITINGCapture runtimeafter direct Play Mode entry
QUEUEDThe command pump stays awake
The window is a control surface. It is not the engine.
The Bridge processor runs whenever the Unity Editor and project are open. Closing its Editor window does not stop command processing, workflow progress, health reporting, or terminal result delivery.
- A heartbeat every two seconds distinguishes live Unity from stale files.
- Commands are atomically claimed, so a domain reload cannot replay them.
- Compile, test, build, workflow, grant, and human-gate state is exported.
- Alepou wakes an idle owning session only for an exact requested result.
bridge-health.json
processor · grant · budgetscompile-status.json
reload · errors · readinessworkflow-status.json
step · progress · barrierDurable workflows
One request can survive the real Unity loop.
Asset import, script compilation, tests, builds, Play Mode transitions, and runtime evidence become ordered barriers with bounded timeouts—not optimistic chat claims.
Deep, typed editing
Scenes, GameObjects, components, prefabs, materials, animation curves, lights, and bounded multi-object edits through explicit schemas.
Structured test runs
EditMode or PlayMode tests filtered by assembly, namespace, category, fixture, or exact test, with JSONL and NUnit evidence.
Validated build jobs
Collision-free outputs under Builds/Alepou/ with artifact path, size, SHA-256, target, scenes, duration, warnings, and errors.
Runtime capture
A bounded Game-view image, Play Mode console evidence, and named object/component probes after a direct human Play Mode gate.
Optional Meta Quest adapter
From a verified APK to one exact headset.
Alepou can hand a successful Android build manifest to Meta's separately installed metavr toolchain for bounded device discovery, install, launch, logs, screenshots, and performance traces.
Device authority is separate from the Unity grant. Automatic approval can name one device, one application ID, exact actions, an expiry, a job budget, and the frozen APK hash.
See the Canvas-to-Quest storyInstall in the Unity project
A normal Unity package, with a visible health check.
During pre-release development, install from a local Alepou checkout so the package tracks the source you are testing. The stable public Git URL will be published only after its versioned tag passes the clean-project release check.
- Open Unity Package Manager.
- Choose Add package from disk.
- Select
unity-bridge/com.alepou.unity-bridge/package.json. - Open Tools → Alepou → Unity Bridge once and confirm the output path.
- Verify
bridge-health.jsonreports a fresh heartbeat andprocessorActive: true.
- Current source
- 0.15.0
- Unity
- 2021.3+
- License
- Apache 2.0
- Processor
- Editor-wide service
Public versioned UPM tag · release validation pending
Package documentation →Alepou Unity Bridge
More autonomy. Better evidence. Authority you can see.
Built for meaningful agent work inside real Unity projects—not a demo command palette.