Run and connect
- Install repository dependencies
PowerShellpowershell bun install --frozen-lockfile - Start browser Inspector
Terminal 1powershell bun run --filter @gua/inspector dev - Start the in-game bridge
The Godot sample starts its bridge inside the game process. Use the sample bridge when you only need to exercise the protocol.
Terminal 2 (sample bridge)powershell bun run bridge:ws - Connect to the URL
texttext ws://127.0.0.1:8765
What to inspect
Screen, role, ID, text, and parent/child structure. Confirm that the expected Controls were collected.
Visibility, enabled state, focus, checked state, value, and bounds used by tests.
Runtime logs published by the game, useful for state changes the connection alone cannot explain.
An explicitly published PNG for comparing semantic state with the rendered frame.
Automation panel
Click, focus, set a value, check/uncheck, select, scroll, or send a key to the selected node.
Record actions, download/import JSON, and replay. Sensitive values resolve from an in-memory secret map.
Use the current screenshot or a selected PNG as a baseline and compare pixels in the browser.
Explicitly download Actual, Expected, Diff images and the comparison manifest.
Desktop development build
Running the Tauri shell from source also requires the Rust toolchain.
bun run --filter @gua/inspector build
bun run --filter @gua/inspector tauri:dev