Skip to content
Back to search

fennara-godot-ai

AI chat and agent tooling for Godot, with both MCP support and in-built native chat window.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/fennaraOfficial/fennara-godot-ai with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/fennaraOfficial/fennara-godot-ai'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fennaraofficial--fennara-godot-ai/badge.svg)](/listings/fennaraofficial--fennara-godot-ai)

HTML

<a href="/listings/fennaraofficial--fennara-godot-ai"><img src="/api/listings/fennaraofficial--fennara-godot-ai/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

- the Fennara addon kept in `res://addons/fennara/` - a small `fennara` CLI installed in Fennara app data - a local MCP server used by AI coding apps - a local daemon that bridges MCP/chat requests to the open Godot editor - generated project guidance for AI agents

The built-in chat dock uses the platform webview: Microsoft Edge WebView2 on Windows, WKWebView/WebKit on macOS, and a Fennara-managed shared CEF runtime on Linux. MCP tools still work if the optional chat dock cannot start.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 229 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Fennara Godot AI
  2. <!-- fennara-doc-nav:start -->
  3. **English** · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Português do Brasil](README.pt-BR.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Türkçe](README.tr.md)
  4. <!-- fennara-doc-nav:end -->
  5. [![Discord](https://img.shields.io/badge/Discord-Join%20Fennara-5865F2?logo=discord&logoColor=white)](https://discord.com/invite/3fF4ft9PTk)
  6. [![Demos](https://img.shields.io/badge/Demos-See%20all-red?logo=youtube&logoColor=white)](docs/demos.md)
  7. [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.md)
  8. Used by Godot developers and teams, including [Somni Game Studios](https://somnigamestudios.com/).
  9. Fennara gives AI assistants a live connection to Godot. Use it from MCP-capable apps like Codex, Claude, Cursor, Gemini, and Antigravity, or from the optional in-editor chat dock.
  10. Agents can inspect scenes, check scripts, capture screenshots, read runtime errors, and validate changes inside the editor instead of guessing from project files alone.
  11. <table>
  12. <tr>
  13. <td width="46%">
  14. <a href="https://www.youtube.com/watch?v=2vSYP7GyA5U">
  15. <img src="https://i.ytimg.com/vi/2vSYP7GyA5U/hqdefault.jpg" alt="Comparing Fennara with other Godot MCPs" width="100%" />
  16. </a>
  17. </td>
  18. <td>
  19. <strong>Watch the featured demo</strong><br />
  20. Comparing Fennara with other Godot MCPs.<br />
  21. <a href="https://www.youtube.com/watch?v=2vSYP7GyA5U">Play this video</a><br />
  22. <a href="docs/demos.md">Browse all demo videos</a>
  23. </td>
  24. </tr>
  25. </table>
  26. ## What It Does
  27. - exposes Godot-aware tools to external AI apps through MCP
  28. - adds an optional local chat dock inside the Godot editor
  29. - returns real Godot feedback: scene trees, diagnostics, screenshots, runtime logs, and validation results
  30. - keeps the agent accountable to the open editor instead of only the filesystem
  31. External MCP apps and the built-in chat use separate model settings. See [MCP Apps And Built-In Chat](docs/chat-vs-mcp.md) and [Built-In Chat Providers](docs/providers.md).
  32. ## Requirements
  33. - Godot 4.5 or newer.
  34. - A supported desktop OS: Windows x86_64, Linux x86_64, or macOS arm64.
  35. - An MCP-capable coding app only if you want to use Fennara from Claude, Codex, Cursor, Gemini, Antigravity, or another external AI app.
  36. - A chat provider only if you want to use the built-in Fennara chat dock. This can be a cloud provider key or a local provider such as Ollama / LM Studio.
  37. For the full install walkthrough, see [Setup](docs/setup.md).
  38. ## What Setup Adds
  39. - the Fennara addon kept in `res://addons/fennara/`
  40. - a small `fennara` CLI installed in Fennara app data
  41. - a local MCP server used by AI coding apps
  42. - a local daemon that bridges MCP/chat requests to the open Godot editor
  43. - generated project guidance for AI agents
  44. The built-in chat dock uses the platform webview: Microsoft Edge WebView2 on Windows, WKWebView/WebKit on macOS, and a Fennara-managed shared CEF runtime on Linux. MCP tools still work if the optional chat dock cannot start.
  45. ## Install
  46. On Windows and Linux, choose either the addon or CLI install. On macOS, use the
  47. CLI install below if you want to avoid the macOS security notification that can
  48. appear after manually downloading and extracting the addon ZIP.
  49. ### Add The Addon To Your Project
  50. - Open the [Latest Release](https://github.com/fennaraOfficial/fennara-godot-ai/releases/latest), download `fennara-addon-latest.zip`, and extract its `addons/fennara/` folder into your project.
  51. Open the project, select the Fennara dock, and press **Set Up Fennara**.
  52. Fennara is an editor dependency, not a game runtime dependency. During export,
  53. the editor plugin removes its runtime autoload from the exported project and
  54. skips `res://addons/fennara/` and `res://.fennara/`. The editor project is
  55. restored after the export finishes. If a CI checkout excludes the addon with
  56. `.gitignore`, run `fennara prepare-export --project path/to/project` before
  57. starting Godot, or install the addon in that checkout. Godot validates autoload
  58. paths before export plugins can run, so this preparation must happen first.
  59. > **macOS:** The release addon contains a native library that is not currently
  60. > Apple-notarized. If you download the addon ZIP through a browser and extract
  61. > it manually, macOS may report that it cannot verify
  62. > `libfennara.macos.editor` is free of malware. To avoid this notification, use
  63. > the CLI installation below. If you already see the notification, close Godot,
  64. > remove the manually copied `addons/fennara/` folder, then install Fennara with
  65. > the CLI.
  66. ### Install With The CLI (Recommended On macOS)
  67. The CLI installs the same Fennara addon. It is the recommended installation
  68. method on macOS because it avoids the browser and Finder quarantine path that
  69. causes the notification described above.
  70. Install the CLI on Windows:
  71. ```powershell
  72. irm https://raw.githubusercontent.com/fennaraOfficial/fennara-godot-ai/main/install.ps1 | iex
  73. ```
  74. Or on macOS and Linux:
  75. ```bash
  76. curl -fsSL https://raw.githubusercontent.com/fennaraOfficial/fennara-godot-ai/main/install.sh | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 104 on GitHub
  77. ```
  78. Then run Fennara from your Godot project:
  79. ```bash
  80. cd path/to/your-godot-project
  81. fennara install
  82. ```
  83. See [Setup](docs/setup.md) for troubleshooting and [Fennara CLI](docs/cli.md)
  84. for the complete command reference.
  85. ## Set Up A Provider Or Connect An MCP App
  86. ### Built-In Chat
  87. Open **Chat Settings > Chat**, select **Open providers**, and connect a provider.
  88. Fennara uses your own key for cloud providers (BYOK). You can also use a local
  89. Ollama or LM Studio server. See the [supported provider list](docs/providers.md).
  90. ### MCP Apps
  91. Open **Chat Settings > MCP Apps**, find your app, and press **Set Up**.
  92. You can also connect an app from the terminal:
  93. ```bash
  94. fennara mcp-setup --codex
  95. fennara mcp-setup --help
  96. ```
  97. If your MCP app is not listed in Chat Settings, see [MCP Setup](docs/mcp-setup.md)
  98. for the complete app list and manual configuration instructions.
  99. ## Update
  100. When the Fennara dock shows **Update**, press it and follow the prompts.
  101. > **Upgrading from Fennara v0.3.8 or older:** Reinstall the CLI once with the
  102. > platform install command above before running `fennara update`. Those CLI
  103. > versions resolve a retired release tag and cannot discover current releases.
  104. > Reinstalling the CLI switches future updates to GitHub's Latest Release
  105. > endpoint and does not remove your existing project addon or settings.
  106. > **macOS users upgrading from Fennara v0.3.11:** Reinstall the CLI once with
  107. > the macOS install command above before updating. The v0.3.11 CLI rejects the
  108. > existing macOS framework bundle before it can self-update. Reinstalling only
  109. > replaces the CLI; it does not remove your project addon or settings.
  110. To update from the terminal, close Godot and run:
  111. ```bash
  112. cd path/to/your-godot-project
  113. fennara update
  114. ```
  115. See [Update Fennara](docs/setup.md#update-fennara) for recovery and diagnostics.
  116. ## Tools
  117. Fennara exposes a small set of Godot-aware tools:
  118. - write or update project files and return diagnostics
  119. - run one-off scene edit scripts
  120. - inspect scene trees, nodes, resources, and Godot classes
  121. - validate scenes
  122. - capture screenshots
  123. - start runtime sessions and read runtime logs
  124. - run small runtime scripts against a live scene
  125. The goal is not to replace an agent's normal file tools. Fennara gives the missing Godot feedback loop.
  126. ## Privacy
  127. Fennara sends one anonymous active-installation event at most once per UTC day
  128. after Godot connects. It contains a random installation UUID, Fennara and Godot
  129. versions, operating system, and CPU architecture. It does not contain project
  130. data, paths, prompts, tool activity, logs, screenshots, or account information.
  131. Telemetry can be disabled in **Chat Settings > Chat > Anonymous telemetry**,
  132. with `FENNARA_DISABLE_TELEMETRY=true`, or with `DO_NOT_TRACK=1`. See [Anonymous
  133. Telemetry](docs/telemetry.md) for the complete payload, storage, transport, and
  134. opt-out contract.
  135. ## Demos
  136. Watch a hands-on Fennara walkthrough:
  137. [![This Godot Plugin Revolutionizes AI Game Development Forever](https://i.ytimg.com/vi/pijlHyiOnz4/hqdefault.jpg)](https://www.youtube.com/watch?v=pijlHyiOnz4&t=22s)
  138. More videos:
  139. - [I Gave Codex an AI Game Image and It Built This in Godot](https://www.youtube.com/watch?v=ztbH6zBhxMc)
  140. - [Fennara MCP Builds a Katamari-Style Godot Game](https://www.youtube.com/watch?v=8y2Ub8pgNSs)
  141. - [This Godot Plugin Transforms AI Game Development Forever](https://www.youtube.com/watch?v=wKln8248y2M)
  142. See [Demos](docs/demos.md) for more videos from the Fennara channel.
  143. ## Star History
  144. <!-- Generated daily by .github/workflows/star-history.yml. -->
  145. <a href="https://github.com/fennaraOfficial/fennara-godot-ai/stargazers">
  146. <img alt="Star History Chart" src="https://raw.githubusercontent.com/fennaraOfficial/fennara-godot-ai/star-history/star-history.svg" width="700">
  147. </a>
  148. ## Documentation
  149. | Start with... | When you need... |
  150. | --- | --- |
  151. | [Documentation home](docs/README.md) | Every guide and reference page |
  152. | [Setup](docs/setup.md) | Installation, updates, and troubleshooting |
  153. | [Chat providers](docs/providers.md) | Built-in chat models and keys |
  154. | [MCP setup](docs/mcp-setup.md) | Codex, Claude, Cursor, and other MCP apps |
  155. | [Tools](docs/tools.md) | The Godot feedback available to agents |
  156. | [Anonymous telemetry](docs/telemetry.md) | Data collected, delivery behavior, and opt-out controls |
  157. | [Contributing](CONTRIBUTING.md) | Development and pull request guidance |
  158. ## Community
  159. Questions, setup help, and early feedback are welcome on Discord:
  160. https://discord.com/invite/3fF4ft9PTk
  161. ## License
  162. See [LICENSE.md](LICENSE.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.