Library [Roblox]
Knit-based extension for creating services in Roblox.
Library brings your Roblox workflow into VS Code — a live DataModel graph, two-way script sync with Studio, AI scripting help, Git integration, Open Cloud DataStore management, and a metadata layer for notes and TODOs. All of it without leaving your editor.
Features
Live DataModel graph. Your entire game as a clickable node tree rendered inline in VS Code. Pan, zoom, click to open a script, push or pull individual nodes. Beats a file tree for navigating real Roblox projects.
Two-way Studio sync. A small plugin runs inside Roblox Studio and talks to the extension over a local HTTP bridge (127.0.0.1, token-auth'd). Save a .luau file in VS Code, it pushes to Studio. Edit a script in Studio, it writes back to disk.
Auto-installed plugin. No file downloads, no drag-and-drop. The first time you start the bridge, Library drops the plugin straight into your Studio Plugins folder. Restart Studio once to pick it up, and you're connected.
Knit-aware project discovery. No manifest file required. Library walks your workspace and maps folder structure to Roblox services using conventions — ServerScriptService/, ReplicatedStorage/, etc. Files with .server.luau, .client.luau, and .luau suffixes are classified automatically.
AI scripting. Claude integration for generate, explain, and refactor — bring your own Anthropic API key.
Open Cloud + DataStores. Full DataStore browser with versions and export. Published-place listing. Messaging Service publishing.
Metadata layer. Attach notes, TODOs, and tags to any script in your project. All stored locally in .library/meta.json.
Git + GitHub. Branch list, status, log, diff, stage, commit — inline in the dashboard.
StyLua + Selene. Lint and format your Luau code with the tools Roblox developers actually use.
Six themes. Void (black + cyan), Oceanic, Sunset, Forest, Rose, Mono. Switch via the command palette, Settings drawer, or during the first-run tutorial.
Getting started
- Install the extension.
- Open a folder that contains (or will contain) your Roblox project.
- The first-run tutorial walks you through connecting your Roblox account, picking a theme, and installing the Studio plugin.
- Open the Bridge item on the left sidebar and click Start bridge. The plugin auto-installs to your Studio
Plugins folder.
- Open or restart Roblox Studio. The Library button appears in the toolbar. Click it — plugin auto-connects to VS Code.
Commands
All commands are prefixed with Library: in the command palette (Ctrl+K, or Cmd+Shift+P):
- Connect your Roblox account
- Open dashboard
- Disconnect account
- Sync with Roblox Studio
- Import
.rbxlx place file
- Initialize project in workspace
- Refresh Roblox profile
Inside the dashboard there are ~40 more commands — hit Ctrl+K with the dashboard open.
Settings
library.bridge.port — Port the Studio bridge listens on. Default 34872.library.bridge.autoStart — Start the bridge automatically when the workspace opens. Default false.library.sync.mode — twoway (default), pull, or push.
Requirements
- VS Code 1.85.0 or newer
- Roblox Studio (Windows, macOS, or Linux via Grapejuice)
- Optional: an Anthropic API key for AI features, an Open Cloud API key for DataStore features, the
gh CLI for GitHub integration, stylua / selene for Luau tooling
Honest limits
- Open Cloud does not allow direct
.rbxl download, so Library can't fetch your published places as files. The "Open in Studio" button uses the roblox-studio:// URL scheme instead, which Studio itself handles.
- AI features require your own Anthropic API key. The extension does not proxy through any server.
- Git integration requires
git and optionally gh on your PATH. If they're missing, the Git drawer tells you clearly rather than pretending to work.
Privacy
- No telemetry.
- API keys are stored in VS Code's
SecretStorage (OS keychain on macOS/Windows, libsecret on Linux).
- Bridge traffic is local-only (
127.0.0.1) and token-authenticated.
- The project metadata file (
.library/meta.json) lives in your workspace. Check it into git, or add it to .gitignore — your call.
License
MIT — see LICENSE.
Support
