wtf

README.md

@@ -205,6 +205,22 @@ auto cube = Mesh::CreateCube();
 - **Memory Pools**: Reduced allocation overhead
 - **Cache-Friendly Design**: Data structures optimized for CPU cache
 
+## AI God Mode
+
+Let Claude play god in the world. The engine exposes a JSON HTTP API on
+`localhost:9090`; `ai_god.py` wires Claude up to it via tool-use and lets the
+model experiment autonomously — querying state, spawning geometry, moving
+the camera, iterating on compositions.
+
+```bash
+pip install -r requirements.txt
+export ANTHROPIC_API_KEY=sk-ant-...
+./build/ModernEngine &
+python ai_god.py
+```
+
+Useful flags: `--max-turns N`, `--port 9090`, `--prompt "build a solar system"`.
+
 ## Contributing
 
 1. Ensure your compiler supports C++23