Agent-first Roblox development. Luau lives in git. The place file lives in git. Studio stays open for playtest and the world — driven by MCP.
The CLI is robld (say robuild). One binary on macOS and Windows. Point it at a new game or an existing place, re-run until it prints READY, then let your agent edit scripts on disk while Studio Script Sync and MCP handle the rest.
Roblox Studio is great for seeing the world. It is awkward as the source of truth for an AI coding agent. Robuild flips that:
- Scripts are normal
.luaufiles in the repo (Script Sync keeps Studio honest). - World state (instances, lighting, maps) is
place.rbxlx, saved into git. - Playtest, inspect, parts, assets go through Studio’s MCP server.
Your agent does not fight the Studio UI to start sync. robld bootstraps prefs, the sync map, a small Studio plugin, and MCP config — then waits until the place is actually ready.
Open robld.com, copy the install prompt (source: INSTALL-PROMPT.md), and paste it into Claude Code, Codex, Grok Build, or Cursor. That puts robld on PATH and runs robld --install in your project. robld --version prints the version; robld --update updates it and reinstalls the skill.
After install, from the game folder:
robld --new "My Game"
# re-run until READY
robldWindows is the same command (robld). On macOS, --new seeds UniqueIds so the first launch can auto-resume Script Sync. Exit 2 still means do Sync to… once (Windows, or if resume did not bind).
| Exit | Meaning |
|---|---|
0 READY: |
Studio is on the place, Luau is on disk, MCP config written. |
1 NEED_PLACE: / ERROR: |
Pass --new, a game URL, or fix Studio. |
2 NOT_READY: |
Do Sync to… once in Explorer, then re-run robld. |
How-to is the skill (skill/SKILL.md, installed into a project with robld --install). Install prompt: INSTALL-PROMPT.md. Agent rules: AGENTS.md. Studio internals we reverse-engineered: NOTES.md.
| In git | Owned by |
|---|---|
*.luau under synced folders |
Script Sync (Studio ↔ disk) |
place.rbxlx |
Studio Save — maps, instances, lighting |
place.json |
robld (ids, local path, name) |
robuild-sync.json |
robld (Studio folder ↔ disk folder map) |
On-disk artifact names still use the robuild-* prefix so existing projects keep working. The command you type is robld.
roblduntilREADY.- Agent edits Luau in the tree (not via MCP script writes for synced files).
- MCP for playtest, screenshots, parts, meshes.
- After world edits on macOS:
robld save(Accessibility keystrokes → File → Save). - Commit scripts +
place.rbxlx.
Built for agents that already live in your editor — Grok, Claude, Codex, Cursor, and friends. Roblox stays Roblox. The repo becomes the product.
This GitHub repository is the CLI. From a checkout:
cd cli && go build -ldflags="-X main.version=dev" -o robld .Windows: cd cli then go build -o robld.exe ..