OmniDebugLink
Remote debugging and automated testing on real devices — from anywhere.
Add a small client SDK to your app, connect it with a device token, and any AI coding tool (Claude Code, Cursor, Codex, Gemini CLI, …) can inspect and drive the running app over Model Context Protocol: dump the UI tree, take screenshots, tap, swipe, type, read logs, measure performance — no USB cable, no shared network, no emulator.
Your App ──wss──> OmniDebugLink relay ──MCP──> AI coding tool
- One outbound WebSocket from the device — works across networks, behind NAT, on real hardware.
- The AI side sees plain MCP tools:
list_devices→run_task/device_status/list_tasks… - One token pair = one device seat. Tokens are per-device; never embed one in a release build — release use goes through the conditional pattern.
Client SDKs
| Platform | Install | Repo |
|---|---|---|
| Unity | Package Manager → add from git URL | omnidebuglink_unity |
| Android | JitPack: com.github.omnidebuglink:omnidebuglink_android:<tag> | omnidebuglink_android |
| Flutter | pubspec git dependency (ref: tag) | omnidebuglink_flutter |
| iOS / macOS | Swift Package (iOS 15+ / macOS 12+) | omnidebuglink_apple_swift |
| React Native | npm i omnidebuglink/omnidebuglink_react_native#<tag> | omnidebuglink_react_native |
| Godot | copy the addons/omni_debug_link/ folder (Godot ≥ 4.2) | omnidebuglink_godot |
| Web | CDN build via jsDelivr (@<tag>) | omnidebuglink_web |
Each SDK repo has the full install steps and task tables for its platform.
Pin a version tag (#vX.Y.Z / ref: / @vX.Y.Z) in production hosts.
Quickstart
-
Create a device token pair at the console (free during the public beta).
-
Connect your app: add the SDK for your platform and start it with the token — freely in debug builds; in release builds only via the conditional pattern (runtime-issued token, never embedded).
-
Add the MCP server to your AI tool (OAuth login in the browser):
claude mcp add --transport http odl https://api.omnidebuglink.dev/mcpWorks with any MCP client: Cursor, Codex CLI, Gemini CLI, …
-
Ask the AI to
list_devicesand start driving the device.
Integrating an SDK into your app
sdk-integration.md is written to be handed to your AI coding tool verbatim — per-platform install and connect snippets, the rules that must not be broken, and a verification checklist. Ask the agent to read it and wire the SDK in.
Building a client for another platform?
Any platform with a WebSocket client can join — the wire protocol is a single JSON frame format:
→ Third-Party Client Development Guide — protocol spec, a portable reference implementation, known pitfalls, and a pre-deployment verification checklist. AI coding agents can implement a compliant client from this guide alone, without reading any SDK source.
Links
- Website · Console
- Third-party client guide
- SDK repositories: see the table above