Making games from Gemini CLI
Gemini CLI is a terminal agent with a low entry cost, which is why people reach for it. Flockbay ships an MCP server, so it can drive the capability layer. The thing worth understanding is why reading a project is not the same as being able to change it well. Free AI to start: Flockbay's AI and your own Claude, ChatGPT, agent or API key are free for your first build; after that, a plan keeps you building. It runs on Windows, macOS and Linux, on the official Godot engine.
The main page on this subject is Connect your own agent.
AppImage, x86_64. Ubuntu 22.04, Debian 12, Fedora 39 or newer.
Intel or AMD Chromebook, with Linux turned on.
Reading the project is the easy part
A capable agent pointed at a Flockbay project can read all of it. The project is a real Godot project in a folder on your machine, in ordinary text formats, so there is nothing to unpack and nothing hidden. Ask what a script does and you will get a decent answer.
That feels like most of the problem solved and it is not. Understanding a project tells you what is there. It does not tell you what should be there, and it does not give you a safe way to put it there. An agent that has read every file still has to decide how to express a change, and in a bare game project the only vocabulary available is text: rewrite a .tscn file, its resource IDs and UIDs by hand, and hope the scene still loads.
That is typing, not operating the engine. A model composing at that grain can be wrong in a hundred small ways that each look reasonable when you inspect them one at a time.
What the editor and the running game add
Flockbay ships one MCP server inside the desktop app, flockbay, and it carries the scene tools, the asset library, and the game itself, which it can edit in the open Godot editor, run, look at and play. A node added through the editor is written by the editor, UIDs and undo step included, and a change is checked by playing the game, holding an input action and reading a value off the live scene tree.
The editor and the running game are code that already exists and already works, which means the model does not have to invent them. Less invention means fewer failures.
So the interesting difference is not context size or how much of your project an agent can hold at once. It is whether the surface it is calling was designed for games or is just the engine's internals with a protocol taped on.
More on this: How do AI game makers work?
A free agent on a free-to-start platform
Worth being direct, because the low entry cost is often exactly why people picked this tool. Connecting your own agent over MCP is free for your first build, and a plan keeps it building after that. The platform itself is free to start. Whatever your agent costs you is separate and unrelated.
The Flockbay download is free, building with it is free to start, and Flockbay's own AI ships inside the app and runs on its hosted model or your Claude or ChatGPT plan, your own agent, or an API key, free for your first build.
Flockbay’s hosted AI is free to start. After your first build, a plan keeps you building. Flockbay builds from a library of ready-made objects, or with Godot's own shapes. There is no better engine, tool set or capability layer to pay for.
One extension, and a shared protocol
We speak MCP; Gemini CLI speaks MCP. On Windows, Flockbay publishes one Gemini CLI extension, and all it does is register the server: gemini extensions install https://github.com/flockbay/flockbay-plugin. There is no partnership beyond that. Any client that speaks the protocol should work, and the ones people ask about are simply the popular ones. We have not tested them all and behaviour varies.
The setup is at the end of this page. In the Flockbay app, Connectors, then Connect your agent (MCP), then Set up writes it with your own paths filled in, which is why you copy it from there rather than type it.
More on this: Making games from Cline
What stays with you is the verdict
A connected agent builds the scenes through the same tools Flockbay's own AI calls: the player controller, characters and props in a 3D project, TileMapLayers and sprites in a 2D one, with terrain, water or a sky from a Godot plugin. It plays what it built before it reports back: a headless run or a window, input events, stdout and the debugger, a viewport capture. Judging what it made stays with you.
You play the game, decide what is wrong, and say so. That loop is the normal work here rather than a sign the tooling failed. When the call is pure taste, nudge the crate or move the sprite yourself in the Godot editor's own 3D or 2D view, and Ctrl⌘+Z takes it back. A sentence gets you a layout; your hand can get you the exact layout.
Flockbay itself is a desktop application for Windows, macOS and Linux with Godot inside it. Games run locally when you press play. Building needs an internet connection because the AI and asset generation come over the network; playing what you already built does not.
More on this: Is there a Flockbay command line?
Connecting it is one paste
The Flockbay app writes this for you with the real paths filled in: open Connectors, press Set up on Connect your agent (MCP), press Turn on, pick Gemini CLI and press Copy. The three paths are specific to your machine and stay the same from one sitting to the next, so you paste it once. Below is the shape, with the paths as placeholders.
Add it to %USERPROFILE%\.gemini\settings.json on Windows, or ~/.gemini/settings.json on macOS and Linux, next to anything already under mcpServers.
More on this: How to make games in Claude Code: from install to a game you can play
{
"mcpServers": {
"flockbay": {
"command": "<node>",
"args": [
"<coordinator>",
"--external-stage-mcp"
],
"env": {
"FLOCKBAY_MCP_DESCRIPTOR": "<descriptor>"
}
}
}
}Questions
- Is there a Gemini CLI integration?
- Not a bespoke one. Flockbay ships one MCP server, Gemini CLI is an MCP client, and that shared protocol is the connection. We do not publish an extension.
- If my agent is free, is this free?
- Yes, for your first build: connecting is free, and a plan keeps it building after that. You pay your agent's provider for the model.
- Does a bigger context window help?
- It helps an agent read your project. It does not give it good operations to call, which is the part that decides whether the result is right.
- Can the agent design the levels?
- It can build them: build the scenes, set up the player controller and place props, add terrain, water or a sky from a Godot plugin, then play the result to check it. Whether a level plays well is yours to judge, by playing it.
- Do I need Godot installed?
- No. Godot ships inside the Flockbay desktop app on Windows, macOS and Linux.
Free to download for Windows, macOS and Linux. Connecting your own agent over MCP is free for your first build, and a plan keeps it building after that.
Download Flockbay free