Unbound
Login

AI Agents

Connect a coding agent to your phone and teach it Unbound.

Give an agent the ubd mcp server to run code on your phone, and Unbound's skills to know which commands to use. With both, it can push a change and check it before reporting done.

Setup

  1. Start the Bridge

    Start it and connect your phone, as in Debugger.

    bunx @unbound-app/debugger

  2. Register the Server

    For Claude Code or Codex:

    claude mcp add unbound -- bunx --bun @unbound-app/cli mcp
codex mcp add unbound -- bunx --bun @unbound-app/cli mcp

    Other agents read a JSON config:

    {
	"mcpServers": {
		"unbound": { "command": "bunx", "args": ["--bun", "@unbound-app/cli", "mcp"] }
	}
}

    For another bridge port, add --port <port> after mcp.

  3. Install the Skills

    The skills live in the Unbound repository. The skills CLI installs them:

    npx skills add marioparaschiv/unbound
npx skills add marioparaschiv/unbound --skill unbound-plugins unbound-debugger -a claude-code -g
npx skills add marioparaschiv/unbound --list

    Without flags it asks which skills and which agent. -g installs for every project. npx skills update pulls newer versions. You can also copy a folder from skills/ into your agent's skills folder, such as ~/.claude/skills/.

  4. Verify

    Restart the agent and ask for your phone's status. It should call the status tool and name the device. If no device is connected, check that the bridge runs and shows the phone as connected.

Skills

SkillUse
unbound-cliPick the right ubd command, and read its JSON output and exit code.
unbound-pluginsScaffold a plugin, lay out its files, write start and stop, keep launch cost low.
unbound-patchingFind a module, store or component, and patch a function, render or Flux action.
unbound-debuggerStart the bridge, register ubd mcp, hot reload with ubd dev or ubd debug push, check on the phone.
hermes-internalsRead Discord's decompiled JavaScript when a lookup finds nothing, often after an update.
react-native-internalsInspect native views and hook native methods when a patch ran but the screen didn't change.

An agent loads a skill only when the task matches, so installing all six costs nothing up front.

Tools

WhereCommands
MCP toolsThe ubd debug commands by name: eval, status, push, reload, open, route, modules, trace, profile, timing, views, inspect, hook, spans
MCP toolsThe ubd device commands with a prefix: device_install, device_reset, device_save, device_restore, device_snapshots
Terminal onlyThe rest, such as build, check, dev, i18n, publish and device logs, run as bunx --bun @unbound-app/cli <command>

Each tool takes the same options as its CLI command.