Skip to content

Godot Agent Loop 2.0.0

Latest

Choose a tag to compare

@beremaran beremaran released this 04 Aug 01:29
· 22 commits to main since this release
v2.0.0

Godot Agent Loop 2.0.0

Godot Agent Loop 2.0.0 is the lean feedback loop: author files, validate,
run, observe, interact, assert. The tool surface drops from 173 tools to 64 —
109 tools are removed and the advertised core is a reviewed 20-tool surface.

BREAKING: lean tool-surface reduction

  • The catalog shrinks from 173 to 64 tools; 109 are removed: 70 subsystem
    runtime wrappers (UI, audio, physics, terrain, GI, animation, networking,
    and similar), 38 project file/authoring/settings/CI tools, and the
    deprecated godot_tools alias.
  • The advertised core surface is now 20 tools, grouped by role:
    catalog/call (godot_catalog, godot_call), lifecycle (run_project,
    stop_project, get_debug_output, get_project_info, get_godot_version),
    observation (game_screenshot, game_get_scene_tree, game_get_ui,
    game_get_node_info, game_get_errors, game_get_logs), interaction and
    verification (game_scenario, game_wait_until, validate_scripts,
    run_project_tests, verify_project), and editor session/transaction
    (editor_session, editor_transaction).
  • The remaining 44 tools stay available as hidden tools reachable through
    godot_catalog + godot_call: input primitives, privileged generics, node
    generics, and ship tooling.
  • GODOT_MCP_AUTHORING_MODE and benchmark:loop are removed. Clients that
    still call godot_tools receive an unknown-tool error and must switch to
    godot_catalog/godot_call.

Migration

  • Author .gd/.tscn/.tres/project.godot with the coding agent's own
    file tools; use editor_transaction in watched mode for editor-native edits.
  • Reach the 44 hidden tools via godot_catalog + godot_call.
  • Opted-in agents use the privileged reflection/code-execution generics in
    place of the deleted subsystem runtime wrappers.
  • The previously prepared but never tagged 1.2.0 work (editor-bridge routing
    of project.godot mutations) ships in this release; the settings-tools routing
    described in the 1.2.0 notes was removed by the reduction.

Verification

51 unit tests and 23 e2e tests pass on Godot 4.7. Protocol conformance is 5/5
for the 20 advertised tools. The core surface is 32,787 bytes / ~8,197
estimated tokens, a 92.39% reduction against the full 64-tool surface.

Install

npx -y @beremaran/godot-agent-loop@2.0.0

Users of 1.1.6 should update their pinned agent adapter or MCP command to
2.0.0.