8000 GitHub - aduermael/robld: One CLI for your agent to build Roblox games without touching Studio. · GitHub
[go: up one dir, main page]

Skip to content
aduermaelPublic

About

One CLI for your agent to build Roblox games without touching Studio.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

24 Commits

Folders and files

Repository files navigation

Robuild

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.

Why it exists

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 .luau files 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.

Install with an agent

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.

Quick start

After install, from the game folder:

robld --new "My Game"
# re-run until READY
robld

Windows 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.

What you version

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.

Everyday loop

  1. robld until READY.
  2. Agent edits Luau in the tree (not via MCP script writes for synced files).
  3. MCP for playtest, screenshots, parts, meshes.
  4. After world edits on macOS: robld save (Accessibility keystrokes → File → Save).
  5. 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.

Developing this repo

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 ..

About

One CLI for your agent to build Roblox games without touching Studio.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0