Ro Sync

Two-way filesystem sync between Roblox Studio and your editor, plus an agent-friendly CLI that can read/write the live DataModel while Studio is open.

• Safe scope — Scripts and Folders sync bidirectionally. Every other class is Studio-authoritative and surfaced via a read-only tree.json skeleton. No reflection-based property round-tripping, no .meta.json files.
• Agent surface — A rosync CLI speaks to the daemon to inspect, mutate, and introspect Studio over WebSocket: get, set, new, rm, mv, call, attr, tag, select, find, classinfo, enums, logs, waypoint, undo, redo, eval, and more.
• Terminal 64 widget — Ships with a web-based widget UI (index.html, app.js, views/) that runs inside the Terminal 64 host, manages projects, supervises the daemon, and resolves conflicts.

Layout

daemon/        Rust daemon — HTTP + WebSocket server, filesystem watcher, conflict detector
plugin/        Roblox Studio plugin (Plugin.luau) — WS client, DataModel mirror, remote handlers
views/         Terminal 64 widget views (projects, active, conflicts, settings, modals)
app.js         Widget router + state store + daemon supervisor
bridge.js      postMessage + SSE helpers for the T64 host
index.html     Widget entry
style.css      Widget styles

Supported platforms

Platform	Daemon	Widget UI	Plugin install
macOS (arm64)	✅	✅	~/Documents/Roblox/Plugins
Windows (x86_64)	✅	✅	%LOCALAPPDATA%\Roblox\Plugins
Linux (x86_64)	✅	⚠️ daemon + CLI only (Roblox Studio isn't native)	—

The widget detects the host OS from navigator.userAgent at load time and picks the matching binary (rosync-darwin-arm64, rosync-windows-x86_64.exe, or rosync-linux-x86_64) from daemon/. All three are produced by the release workflow.

Building from source

macOS / Linux:

cd daemon
./build.sh         # emits rosync-<os>-<arch> next to Cargo.toml

Windows (PowerShell):

cd daemon
.\build.ps1        # emits rosync-windows-x86_64.exe

Or pull pre-built binaries from GitHub Releases and drop them in daemon/.

Plugin: the widget's Settings → Install button copies plugin/Plugin.luau into the correct Studio plugin folder for your OS. Or do it manually.

Daemon

rosync serve --project /path/to/studio/project --port 7878

On first run the daemon writes ro-sync.md (agent docs) and CLAUDE.md (import line) into the project root.

CLI

Full subcommand list:

rosync help
rosync <subcommand> --help

Highlights:

rosync query --project /path '**/RemoteEvent' --format paths
rosync get  --path Workspace/Baseplate
rosync set  --path Workspace/Part --prop Transparency --value 0.5 --yes
rosync new  --path Workspace --class Folder --name Enemies --yes
rosync find --class RemoteEvent
rosync logs --since 5m --level warn
rosync waypoint --name "big-change" && rosync undo --yes

eval is available as an escape hatch:

rosync eval --source 'return #workspace:GetDescendants()' --yes

Safety

• All mutating CLI ops require --yes.
• set Parent = ... refuses by default (use rosync mv instead); override with --force-parent.
• Cross-service mv requires --force.
• Writes are audited to ~/.terminal64/widgets/ro-sync/writes.log (rotated at 10 MiB).

License

No license file yet — treat as "all rights reserved" until one is added.