Hera Agent Godot lets AI coding agents inspect and control a live Godot 4.7+ editor in real time — instead of guessing scene structure from stale training data, the agent acts on the real editor and checks the result.

This Asset Library entry is the editor addon (the in-editor bridge). The companion hera CLI lives on GitHub and is what the agent actually runs.

Why a CLI, not MCP?

Godot already has a healthy MCP-addon ecosystem — Hera makes the opposite bet on purpose. MCP servers pay for breadth in tokens: dozens to 100+ tool schemas plus verbose JSON responses sit in the agent's context every turn.

Hera delivers MCP-grade reach over the live editor as a compact-JSON-by-default CLI — one command per action, minimal tokens, and it works with anything that can run a shell command (pipes, batch, CI, any agent), not just MCP clients.

What the agent can do

• status — project, version, active scene
• scene — tree / list / open / save
• node — find / get / add / set / remove (undoable)
• signal — list / connect / disconnect (undoable, saved with the scene)
• resource — inspect a .tres / .res / .tscn
• run / stop — play the main / current / a specific scene
• output — tail the project log (errors / warnings)
• eval — evaluate a GDScript expression
• screenshot — render the edited scene to a PNG
• batch — run many commands in one request

All mutations register with the editor's Undo/Redo, so you can Ctrl+Z anything the agent does.

Setup

1. Install this addon (it lands in res://addons/hera_agent_godot/).
2. Enable it: Project → Project Settings → Plugins → Hera Agent Godot. The Output panel shows [hera] ... listening on 127.0.0.1:<port>.
3. Get the hera CLI from GitHub — one-line installers for Windows / macOS / Linux, or build from source with Go.

The addon runs a localhost-only HTTP server (bound to 127.0.0.1) and advertises the editor to the CLI via ~/.hera-agent-godot/instances/. Nothing leaves your machine.

Also using Unity?

Meet the sibling: hera-agent-unity brings the same low-token, shell-native philosophy to the Unity Editor — read console errors, run C#, enter Play Mode, manage GameObjects, build UI, and run tests, all in compact, agent-friendly output. Working across both engines? Your agents get one consistent way to drive each.

→ https://github.com/NotNull92/hera-agent-unity

Links

• Repository, CLI, and full docs: https://github.com/NotNull92/hera-agent-godot
• Unity sibling: https://github.com/NotNull92/hera-agent-unity

MIT licensed.