Roblox Bridge Agent

Start the local RBA websocket bridge used by the Lua autoloader.

Stop the local RBA websocket bridge.

Show websocket bridge status, connected clients, and recent client events.

Return the active RBA websocket host, port, URL, candidate URLs, and published connection-state checks.

Read recent websocket/client events captured by RBA.

Clear buffered RBA events, optionally only those matching type/client filters.

List connected RBA websocket clients.

Diagnose the shared RBA bridge, Instance Manager endpoint, connected clients, autoexec targets, recent errors, and optional eval/ping health.

Read-only Roblox process and RBA heartbeat diagnosis. Reports healthy, bridge_disconnected, not_running, or likely_crashed without changing any process.

Safely restart RobloxPlayerBeta.exe: discover and verify the current/installed executable path, close only RobloxPlayerBeta processes, then launch the verified executable normally.

One development-oriented snapshot: RBA health, Roblox crash likelihood, autoexec state, and optional static script preflight. Does not execute the inspected script.

Verify the complete local workflow: RBA websocket service, Instance Manager connector endpoint, and every executor autoexec copy.

Prepare RBA for an agent session: start or attach the bridge, sync autoexec, optionally start dashboard, notify clients, and return health.

Show an in-game RBA notification on connected Roblox clients.

Update the in-game RBA status panel on connected Roblox clients.

Show full details for one connected RBA websocket client.

Set the default client used when a tool target is omitted.

Close one connected RBA websocket client.

Send Lua source text to connected development clients through the websocket bridge.

Send a Lua file from the RBA workspace to connected development clients.

Run Lua and wait for structured return values or errors from connected clients.

Run a workspace Lua file and wait for structured return values or errors from connected clients.

Execute a workspace Lua file in Roblox, either fire-and-forget send or eval with structured results.

Execute multiple workspace Lua files in order with syntax checks, optional delay, and stop-on-error control.

Run local Lua syntax validation with luac for a workspace file or provided source before sending to Roblox.

Ping connected clients and return round-trip timing plus basic place/job details.

Install debug helpers on connected clients and return an initial runtime snapshot.

Run a built-in realtime probe such as summary, character, camera, players, environment, or datamodel.

Mirror client print/warn output back to RBA events with a Roblox-safe rate limit.

Statically inspect a workspace Lua file or provided source before execution: syntax, metrics, lifecycle/loop checks, dynamic loading, remote calls, and direct transform writes. Never executes the script.

Create a named RBA script capsule: a permission-gated policy envelope around one workspace Lua file. Capsules preflight and snapshot source before dispatch; they do not claim to OS-sandbox code inside a Roblox executor.

List registered script capsules and their explicit permissions, source file, timestamps, and policy-sandbox limitation.

Replace a script capsule's explicit capability grants. The next capsule run is blocked when static source requirements are not granted.

Create a source snapshot for one script capsule. Use it as a time-travel restore point before an edit or experiment.

List time-travel source snapshots for one RBA script capsule.

Restore a capsule source file from a selected snapshot. RBA captures the current source first as a safety snapshot.

Preflight, permission-check, optionally snapshot, and then dispatch a script capsule. Missing required permissions block the run before any Lua reaches a client.

Inspect the RBA workspace Git repository, selected branch/origin, changed and staged files, and the exact autoloader fingerprint without changing Git state.

Explicitly commit selected existing RBA workspace files and optionally push the current branch. It refuses to run with a pre-staged index and never uses git add --all, so unrelated scripts are not swept into a sync.

Restore print/warn after rba_install_console_mirror.

Wait briefly for the next websocket event, optionally filtered by type and client id.

Capture status, clients, recent events, runtime summary, and optional Roblox screenshot in one call.

Watch a workspace Lua file and auto-send or eval it in Roblox on change for live editing.

Watch multiple workspace Lua files as one live-editing session and optionally run them once immediately.

Stop one active RBA file watcher.

Stop every active RBA live-edit file watcher.

List active RBA file watchers.

List script profiles from the workspace profile JSON file.

Run a named script profile from the workspace profile JSON file.

Configure optional profile/file execution that runs automatically when a Roblox client connects.

Show the current RBA autorun-on-connect configuration.

Start the local RBA dashboard HTTP server.

Stop the local RBA dashboard HTTP server.

List built-in Lua websocket presets.

Run a built-in Lua preset on connected development clients.

Return the local character position and CFrame from connected development clients.

Teleport the local character to exact coordinates and remember the previous position.

Teleport the local character to a Workspace BasePart or Model path, with an optional local offset.

Return the local character to its position before the most recent RBA teleport.

Teleport the local player to a Roblox place, optionally joining a specific public server job.

Create or replace a file inside the RBA workspace.

Install the current RBA autoloader into an executor autoexec path, backing up any existing file first.

Sync the workspace unified autoloader to one autoexec target, backing up changed content by default.

Sync the same unified RBA and Roblox Instance Manager autoloader to every configured executor target.

Show every configured executor autoexec target and verify its installed loader hash against the workspace source.

List sidecar backups created for an autoexec target.

Restore an autoexec sidecar backup and preserve the currently installed file first.

Append text to a file inside the RBA workspace, creating it when needed.

Read a workspace file, capped to a safe byte limit.

Create a timestamped backup of a workspace file under .rba-backups.

List workspace file backups, optionally filtered to one original path.

Restore a .rba-backups file, first backing up the current destination when it exists.

Run multiple workspace file operations in one call.

List visible desktop windows that can be used as screenshot targets.

Capture a screenshot of a visible Windows process window and return it as an MCP image.

Capture RobloxPlayerBeta.exe and return the screenshot as an MCP image for visual context.

Read a workspace PNG/JPEG file and return it as an MCP image.

List files inside the RBA workspace.

Search text files inside the RBA workspace.