@beremaran/godot-agent-loop 1.0.0 → 1.1.0

package/addons/godot_agent_loop/README.md

@@ -2,30 +2,40 @@
 
 An optional Godot 4 editor addon for
 [Godot Agent Loop](https://github.com/beremaran/godot-agent-loop). It adds a
-dock with authenticated connection status, live Agent Activity, human
-Pause/Resume Agent control, protocol and Godot compatibility diagnostics, and
-setup help for Claude Code, Codex, OpenCode, and Pi.
+dock with authenticated connection status, live and replayed Agent Activity,
+human Pause/Resume Agent control, and compatibility diagnostics.
+
+Godot 4.7 or later is required.
 
 ## Install
 
-Copy `addons/godot_agent_loop/` into a Godot project, then enable **Godot Agent
-Loop Bridge** under **Project > Project Settings > Plugins**. Installing the
-addon is optional: the external MCP package creates and removes a transient
-bridge when this persistent addon is absent.
+Install this directory as `addons/godot_agent_loop` in the Godot project, then
+enable **Godot Agent Loop** under **Project > Project Settings > Plugins** and
+restart the editor once. The **Agent Activity** dock remains present and says it
+is waiting while no MCP is connected. Opening Godot normally is the recommended
+interactive workflow; `editor_session ensure` discovers it by project.
+
+The addon publishes a private, untracked session record at
+`.godot/godot_agent_loop/editor-session.json`. It contains a fresh per-start
+token and ephemeral loopback port. Do not copy or commit `.godot/`. The record
+is removed on clean editor exit and stale records are rejected by the server.
 
-The addon listens only on loopback. It accepts commands only after a secret
-authenticated protocol handshake from an editor launched through Godot Agent
-Loop. A normally launched editor shows setup diagnostics but does not accept
-agent commands.
+To uninstall, disable the plugin, close Godot, and remove
+`addons/godot_agent_loop`. You may also remove a stale
+`.godot/godot_agent_loop` directory while Godot is closed. MCP cleanup never
+removes this persistent addon.
+
+If an editor was started before the addon was installed and enabled, restart it
+after installation. Godot does not expose a safe public API for loading a new
+`EditorPlugin` into an already running editor.
 
 ## Human control
 
 Use **Pause Agent** before editing shared project state. Inspection remains
 available, while subsequent agent mutations are refused before dispatch. Use
-**Resume Agent** to return control.
+**Resume Agent** to return control. An unsaved scene conflict is preserved and
+reported; the addon never reloads over it.
 
 This addon does not install Node.js, an MCP client, or an AI agent. Follow the
-client setup in the main project documentation, then use `launch_editor` so the
-bridge receives its per-session authentication secret.
-
-Licensed under the MIT License; see [LICENSE](LICENSE).
+client setup in the main project documentation. It is licensed under the MIT
+License; see [LICENSE](LICENSE).

package/addons/godot_agent_loop/plugin.cfg

@@ -3,6 +3,7 @@
 name="Godot Agent Loop Bridge"
 description="Authenticated agent activity, pause control, compatibility diagnostics, and setup help for Godot Agent Loop."
 author="Berke Arslan"
-version="1.0.0"
+version="1.1.0"
 script="plugin.gd"
-protocol_version="1"
+protocol_version="2"
+minimum_godot_version="4.7"