uloop-focus-window git:20260616.7cb6f01A

Immutable. This exact content is served forever at /api/v1/blob/93fd320dc781b5ff.

---
name: uloop-focus-window
description: "Bring the Unity Editor window to front. Use when Unity must be visible for visual checks or user-facing interaction."
---

# uloop focus-window

Bring Unity Editor window to front using OS-level commands.

## Usage

```bash
uloop focus-window
```

## Parameters

None.

## Global Options

| Option | Description |
|--------|-------------|
| `--project-path <path>` | Optional. Use only when the target Unity project is not the current directory. |

## Examples

```bash
# Focus Unity Editor
uloop focus-window
```

## Output

Returns JSON with:
- `success`: Whether the focus operation succeeded
- `message`: Status message (e.g. `Unity Editor window focused (PID: 12345)`, or the failure reason such as `Unity project not found` / `No running Unity process found for this project` / `Failed to focus Unity window: <reason>`)

These are the only two fields. There is no PID, window-handle, or platform field returned to the caller.

## Notes

- **Works even when Unity is busy** (compiling, domain reload, etc.)
- Uses OS-level commands (osascript on macOS, PowerShell on Windows)
- Useful before `uloop capture-unity-window` to ensure the target window is visible
- Brings the main Unity Editor window to the foreground