Settings
This page is a reference to the settings you can change in Roflow, what each one does, and where to find it.
Roflow keeps its settings in a few places depending on what they affect:
- The Settings page in Roflow Home — your account, plan and usage, dashboard preferences, and connection status.
- The Roflow Agent panel's Settings tab — how the agent talks to you and what it's allowed to do automatically.
- The underlying editor settings — advanced preferences like validation and theme, shared with the code editor.
Roflow works well out of the box. The settings worth knowing about are your plan and usage, the agent's auto-approve controls, your preferred language, and the model you pick for a task. The rest you can leave at their defaults.
The Settings page in Roflow Home
Open it from the bottom of the left navigation bar — click the gear (Manage) icon or your account icon, or choose Settings from the left nav. Both land on the same page.
This page pulls together the settings and status that matter most day to day:
| Section | What it shows / lets you do |
|---|---|
| Account | Your Roblox display name, username, and avatar, plus a Sign out control. |
| Plan & usage | Your current plan and a usage meter for the month — how much of your AI allowance you've used, when it resets, and links to upgrade, manage your subscription, or view usage in detail. |
| Dashboard preferences | A Beginner guidance toggle and a layout density choice (Comfortable or Compact). See below. |
| Studio connection | Whether the Studio Bridge is connected, the plugin version, and which place is connected. |
| Component status | Whether the Roflow Agent and Luau language support are active. |
| Editor settings | Shortcuts that open the underlying Settings, Keyboard Shortcuts, and Extensions views for finer control. |
The page also shows the app version and gives you a Sign out button; signing out returns you to the first-run setup wizard.
For what your plan includes and how the usage meter works, see Plans & Pricing and Usage. To sign in, sign out, or switch accounts, see Managing Your Account.
Dashboard preferences
- Beginner guidance — turns extra explanatory hints and guidance in the dashboard on or off. Leave it on if you're newer to Roblox development; turn it off for a leaner view once you know your way around.
- Layout density — choose Comfortable (more spacing) or Compact (tighter, fits more on screen).
The Roflow Agent settings
The agent lives in a side panel with three tabs at the top: Chat, History, and Settings. Open the Settings tab (or run Roflow Agent: Settings from the command palette) to reach the agent's own preferences, grouped into General, Auto-approve, and About.
General — Preferred Language
Preferred Language sets the language the agent uses when it talks to you. The default is English, and there are 18 languages to choose from:
Arabic, Czech, English, French, German, Hindi, Hungarian, Italian, Japanese, Korean, Polish, Portuguese (Brazil), Portuguese (Portugal), Russian, Simplified Chinese, Spanish, Traditional Chinese, and Turkish.
This changes how the agent writes to you; it doesn't change the language of your code.
Auto-approve
By default, Roflow asks before it acts — it shows you each proposed file edit as a diff and each command before running it, and waits for your OK. The Auto-approve settings let you pre-authorize certain kinds of action so the agent can keep moving without stopping to ask.
| Control | What it allows |
|---|---|
| Enable auto-approve | Master switch for the whole feature. |
| Toggle all | Turn every category on or off at once. |
| Read project files | Read files in your project. Optional wider scope: Read all files (anywhere on your computer). |
| Edit project files | Create and change files in your project. Optional wider scope: Edit all files. |
| Execute safe commands | Run terminal commands judged safe. Optional wider scope: Execute all commands. |
| Use the browser | Launch and interact with a web browser. |
| Use MCP servers | Use connected MCP servers (extra tools). |
| Enable notifications | Get a system notification when the agent needs your approval or finishes a task. |
| Max Requests | How many actions the agent may take in a row before it checks back in with you. |
You can also flip these quickly with the star toggles in the chat's auto-approve menu while you work — tighten up for risky changes, loosen up while prototyping.
Even with Execute safe commands on, a command the model judges destructive still asks for your approval. Wider scopes like Edit all files and Execute all commands let the agent act outside your project — use them only when you understand the risk. Your checkpoints remain a safety net, so you can always roll back.
For how approvals, diffs, and auto-approve behave in a conversation, see Talking to Roflow.
About
The About tab shows the Roflow Agent version and related information.
Choosing an AI model
You pick the model for a task from the model button in the chat composer, not from a settings page. It opens a picker with three tiers:
| Tier | Best for |
|---|---|
| Fast | Quick edits, low usage. |
| Balanced | The all-round default coder; can also read images. |
| Max | The most capable tier, for complex reasoning and debugging; high usage. |
Balanced is the default. Higher tiers produce stronger results on hard problems but draw down more of your monthly AI allowance, so the picker notes when a choice uses more.
By default, Roflow uses managed models through your Roflow account — there's no API key to set up. Advanced users can configure an external model provider in the agent settings instead; any provider key you enter is kept in your operating system's secure storage.
For how model choice affects your allowance, see Usage.
Appearance
Roflow ships with two dark themes: Roflow Islands Dark (the default) and Roflow Dark. No light theme is included. You can change the theme from the editor's color-theme picker.
A couple of other defaults worth knowing:
- The menu bar is hidden by default (press
Altto reveal it on Windows, or use the top-bar menus). - Telemetry is off by default.
Validation (advisory Luau/Roblox checks)
After the agent edits a file, Roflow can run advisory Luau and Roblox checks and surface any findings. These are advisory only — they never block an edit.
| Setting | Default | What it does |
|---|---|---|
roflow.validation.enabled | On | Runs advisory Luau/Roblox validation on files after the agent edits them. Turn it off to skip validation entirely. |
roflow.validation.*.path | Empty (auto-detect) | Optional absolute paths to the validation tools. Leave empty and Roflow finds them automatically. |
You can find these under the editor's Settings (open it from the Home Settings page, or press Cmd/Ctrl + ,) and search for roflow. Most creators never need to touch them.
Related settings and controls
A few preferences live as commands or per-project toggles rather than on a settings page:
- Studio sync — run Toggle Studio Sync from the command palette to pause or resume live syncing of your edits into the connected Studio place. The choice is remembered per project. See Studio Bridge.
- Excluding files — a project's optional
.roflowignorefile tells the agent which paths to leave alone. Sensitive paths like.env,*.key,node_modules,.git, andPackagesare ignored by default. - Keyboard shortcuts — remap any command from the editor's Keyboard Shortcuts view (also linked from the Home Settings page). See Keyboard Shortcuts.
See also
- Commands — the full command palette reference.
- Keyboard Shortcuts — Roflow-specific and standard editor shortcuts.
- Talking to Roflow — approvals, diffs, and giving the agent context.
- Plans & Pricing and Usage — what your plan includes and how usage is measured.
- Managing Your Account — signing in, out, and switching accounts.