Skip to content

Flockbay documentation

Flockbay is the Godot editor with an AI agent and an MCP server built in. Compatible with Godot 4.x.

Docs for agents: llms.txt. Every page also has a Markdown copy at its address plus .md, and Copy page on the page itself.

Start with the Quickstart, Open your existing Godot project, or Connect your agent (MCP).

Before you start

  • 64-bit Windows 10 or 11, macOS 15 or later on Apple Silicon, or 64-bit Linux.
  • A GPU with Vulkan 1.0 or Direct3D 12 for Forward+, or OpenGL 3.3 for the Compatibility renderer.
  • An internet connection while you build.
  • Optional: Claude Code, Codex or Cursor, or an API key, to build on your own AI.

System requirements has the rest.

Connect your own agent

Paste this into Claude Code, Codex or Cursor. Your agent connects Flockbay and reads your project, and changes nothing until you ask. Agents can fetch it from /docs/agent-setup-prompt.md.

Text
Connect Flockbay to this session. Flockbay is installed on this computer and serves Godot tools over MCP.

1. Register its MCP server once, for my user. On Windows, in Claude Code run: claude mcp add --scope user flockbay -- flockbay mcp
   In Codex run: codex mcp add flockbay -- flockbay mcp
   In Cursor, add this to ~/.cursor/mcp.json: {"mcpServers":{"flockbay":{"command":"flockbay","args":["mcp"]}}}
   If the terminal says flockbay is not found, tell me to open a new terminal and start again there.
   On a Mac or Linux there is no flockbay command: ask me to paste the line the Flockbay app writes for this machine (Connectors › Connect your agent (MCP) › Set up › Turn on › Copy).
2. Check it: `claude mcp list` or `codex mcp list` lists flockbay. If flockbay is listed but the flockbay_status tool is its only tool, ask me to open the Flockbay app with this game and turn on Connect your agent (MCP), then start a new session.
3. Call flockbay_project_info and tell me in a few lines what this Godot project is: its main scene, its autoloads and the scripts that run the main loop.
4. Change nothing yet. Ask me what to work on.

Who makes Flockbay · Security: what leaves your machine · Status

Godot 4 answers, verified

Common tasks

Get started

Install on Windows

On Windows, flockbay.com gives you a small code-signed installer that downloads Flockbay and runs its setup. Flockbay installs for your user account, with no administrator password, and includes the Godot 4.7.2 editor your games run on.

Install on macOS

Flockbay for macOS is a signed, notarized disk image for Apple Silicon, downloaded from flockbay.com. It is the same app as on Windows, with the Godot 4.7.2 editor your games run on included.

Install on Linux and ChromeOS

Flockbay for Linux is one AppImage for 64-bit Intel or AMD PCs, for Ubuntu 22.04, Debian 12, Fedora 39 (glibc 2.35) or newer. A Chromebook with an Intel or AMD processor runs the same AppImage in ChromeOS’s Linux development environment.

System requirements

Flockbay is a desktop app for 64-bit Windows, macOS on Apple Silicon and 64-bit Linux, and a Chromebook with Linux turned on runs the Linux build. Godot 4.7.2, standard and .NET, is included. There is no phone version.

Quickstart

Install Flockbay, open your Godot project or make a new one, pick the AI that builds, connect your own agent over MCP if you use one, and press F5. Five steps, a few minutes.

Quickstart: your existing Godot project

Open your project, have Flockbay explain its scenes, autoloads and main loop, ask for three small changes and pick one, then review the diff, run the game and revert the turn if it is wrong. Two prompts to copy.

Your account

Downloading Flockbay needs no account, and neither does building. On first launch Flockbay gives the install a guest account, with no browser and no email, and builds on it from your first message. Play and the editor ask for nothing more. Save your account is a free sign-in, needed to share a play link, make a Community profile, or buy a plan. Your AI and keys are in Connectors.

Projects

Open your existing Godot project

A Godot project you made elsewhere opens in Flockbay. Flockbay asks once before it writes anything into it, records everything it adds, and takes it all out again when you ask.

Import a Unity project

Import from Unity makes a new Godot 4 project from a Unity project, without opening or installing Unity. Scenes, prefabs, models, sprites, tilemaps and settings convert on import; the Port report lists what is left, and the AI ports it with you.

New project: blank or template

Flockbay opens on Home: open a Godot project you have, or make a new one. New project asks what Godot’s own Create New Project asks, plus a template and an optional description. Create makes the project with no AI call; a description becomes the first message in its chat, on Flockbay’s hosted AI, which is free to start, unless you pick your own Claude or ChatGPT.

Projects on disk

A project is a Godot project folder on your computer, where you made or opened it. Flockbay keeps no copy of it elsewhere. Its own data and logs are in a separate app data folder.

Open without Flockbay

Every project is a Godot project, and it opens in the Godot editor with Flockbay’s chat docked beside it. Open without Flockbay opens it in the Godot editor without Flockbay’s plugin, with the chat in Flockbay’s own window.

Godot versions and engines

Flockbay works with Godot 4.6+. It includes Godot 4.7.2 in its standard and .NET builds, and runs your projects on it. Your own Godot editors are listed in Settings › Godot versions, and a project from another version can stay on one of them.

Version control with Git and GitHub

A Flockbay game is a Godot project in a folder, so it works with Git. The Version control panel sets the repository up, publishes it to GitHub, and syncs it with the people you work with. Flockbay keeps no copy of your game.

AI and agents

How Flockbay’s agent works

Flockbay’s agent works in turns: you send a message, it calls tools in your project, and the reply ends with a receipt of every file it changed. How much it may do without asking is the chat’s permission mode.

Asking for a change

Ask in the chat. Each turn lists its steps; open a step for its command, output or diff, and the turn ends with a receipt of the files it changed. Then press Play and judge the game.

Managing context

A chat’s context window holds Flockbay’s instructions and tools, then the messages, tool results and pictures in the chat, which go with each request. A game outlives any one chat: keep its plan and conventions in project files, give each task its own chat, and compact between tasks.

Models

Each chat runs on the model picked in the menu beside Send. A new chat runs on Flockbay’s AI, free to start and the same on every plan. The menu also lists your own Claude Code and ChatGPT models, and the models your API keys reach.

Claude Code

Flockbay runs Claude Code, Anthropic’s coding agent, on your own paid Claude account and shows its work in Flockbay’s chat. You pay Anthropic for the subscription you already have, and Flockbay nothing. On Windows, macOS and Linux; on a Mac it uses the Claude Code you have installed or installs it with Homebrew, and on Linux it uses the Claude Code you have installed.

Codex (ChatGPT)

Sign in with ChatGPT and Flockbay’s chat runs on your own ChatGPT account, through the Codex engine that comes with the app. You pay OpenAI for the plan you already have, if it is a paid one, and Flockbay nothing for your first build; after that, a plan keeps you building.

Start here if you use Claude Code, Codex or Cursor

Your agent already reads and writes your GDScript. Connected to Flockbay over MCP, it also runs the game, reads stdout and the debugger, sends input events, captures the viewport and edits scenes through the open Godot editor. Setup is one line or one prompt.

Setup prompt for your agent

Paste this into Claude Code, Codex or Cursor in your game’s folder. Your agent connects Flockbay’s MCP server, checks it, reads the project with flockbay_project_info, and changes nothing until you ask.

Connect your agent (MCP)

The Flockbay app runs an MCP server for the game you have open. Turn it on in Connectors, copy the setup line for your agent, and Claude Code, Codex, Cursor or any other MCP client builds in that game with Flockbay’s tools.

Steam market research in Claude and ChatGPT

Flockbay’s Steam market research runs as a remote MCP server that Claude, ChatGPT and other AI assistants can use with no Flockbay account. Ask about a game idea and your assistant finds comparable Steam games, how they sold and how often games with those tags do well. When you want to build the idea, it saves it with a link that opens it in Flockbay.

The modeler

The modeler is how your AI makes a 3D model without a generation key. It writes a spec of blended shapes, and Flockbay builds a rigged, game-ready model from it on your computer. It costs nothing per model.

Editor

Play and debug

Publishing tools

Reference

Questions

How do I undo an agent’s change?

Press Revert this turn on the turn’s receipt, or type /undo for the newest turn. Revert on a file’s row takes back that file, and Review changes (Ctrl+Shift+R) takes back one hunk. Redo puts a reverted turn back.

How do I review what the agent changed?

Every turn that changes files ends with a receipt, "Changed 3 files +42 −7", and a row per file with its diff. Review changes (Ctrl+Shift+R) opens every file the turn changed in one scroll, beside the chat.

How do I commit the agent’s changes to Git?

Open Version control (Ctrl+Shift+G). Changes lists every uncommitted file with its diff, the commit message is drafted from what you asked Flockbay since the last commit, and Ctrl+Enter commits. Push and Pull are at the top of the panel.

How do I see Godot’s output and errors in Flockbay?

Press Play (F5): the game is attached to the Godot editor’s debugger, prints show in Output, and errors with their stack traces under Debugger › Errors. When Flockbay runs the game itself, its step in the chat shows Godot’s Output and the exit code.

How do I get Godot’s Scene dock and Inspector back?

Every project opens in the Minimal view: the chat and the Game screen. The switch at the right end of the editor’s title bar picks Standard, which adds the Scene and Node docks, the Inspector, FileSystem, the Script editor and the bottom panel, or Full, all of Godot’s editor. It applies at once.

How do I open my project in VS Code or a terminal?

The project menu has Open in your code editor, Open in Terminal and Show in Explorer, each at the project’s folder. Settings › Developer › External editor picks the editor, and every res:// path and error line in the chat opens there at its line.

Does Flockbay change my Godot project?

Only after you say yes. For a project made elsewhere, a card asks Add Flockbay to and the project’s name, and lists everything it writes before it writes it. Open without Flockbay writes nothing, and Uninstall Flockbay from project… takes it all out again.

How do I connect Claude Code to Godot?

Open your Godot project in Flockbay, then Connectors › Connect your agent (MCP) › Set up › Turn on. Pick Claude Code, press Copy, and paste the command in a terminal. In a new Claude Code session, /mcp lists flockbay.