hid-bridge

HID Bridge

A single self-contained CLI (hidbridge.exe) that simulates keyboard and mouse input at the Windows SendInput level (the same input-stack layer real HID devices report through) and captures screenshots / short GIFs of a target window. Built so an agent can actually play a game or actually operate an app rather than just reading its source.

Binary: bin\hidbridge.exe (next to this file — self-contained, no .NET install required). Source and build instructions: https://github.com/PageMastr/AIID

Every command prints exactly one JSON line to stdout: {"ok": true/false, ...}. Always check ok before trusting the rest of a script.

Core workflow

1. Find and focus the target window first. SendInput delivers events to whichever window currently has OS focus — it is not addressed by window handle. Any keyboard/mouse command will go to the wrong place (or nowhere useful) if the target window isn't focused.

   hidbridge.exe window focus <title-or-process-substring>
   

2. Drive it with key/type/mouse commands.
3. Look at what happened with screenshot, or capture a short clip with gif. Read the returned path with the Read tool — screenshots and GIFs are real image files, so you can literally see the game/app state, not just infer it from logs.

Re-run window focus if focus may have been lost (e.g. after alt-tabbing, or if a previous test spawned/killed a process).

Command reference

Window discovery

hidbridge.exe window list                      # all visible top-level windows
hidbridge.exe window find <substring>           # first match, no side effects
hidbridge.exe window focus <substring>           # bring to foreground + activate
hidbridge.exe window active                      # what currently has OS focus (debugging)
hidbridge.exe window rect <substring>            # client-area rect in screen coords (debugging)

Matches against both window title and process name, case-insensitive substring. window focus verifies the target actually became the foreground window (ok is false if something else grabbed focus first) — if that happens, just retry the focus call right before the input you're about to send.