List all objects in the Three.js scene tree. Returns compact text tree by default (saves tokens). Set compact=false for full JSON.

Get detailed info about a specific object by name, uuid, or path

List all materials in the scene with type, color, transparency

Get full properties of a material: color, maps, uniforms, defines

Get compiled vertex/fragment shader source and uniforms for a material

List all compiled shader programs with their material associations

List all textures: size, format, wrap, filter settings

Get detailed info about a specific texture

Get renderer stats: draw calls, triangles, memory, capabilities

Set a material property (color, roughness, wireframe, etc.). IMPORTANT: This is a runtime-only preview (lost on reload). Before calling, ASK the user whether they want a runtime preview or a persistent code change.

Runtime preview — lost on page reload. You MUST ask the user first: runtime preview only, or also update source code?

Set a shader uniform value on a ShaderMaterial — runtime-only preview (lost on reload). ASK the user first: runtime preview or persistent code change?

Runtime preview — lost on page reload. You MUST ask the user first: runtime preview only, or also update source code?

Set position, rotation, scale, or visibility of a scene object — runtime-only preview (lost on reload). ASK the user first: runtime preview or persistent code change?

Runtime preview — lost on page reload. You MUST ask the user first: runtime preview only, or also update source code?

Modify light properties: color, intensity, position, shadows — runtime-only preview (lost on reload). ASK the user first: runtime preview or persistent code change?

Runtime preview — lost on page reload. You MUST ask the user first: runtime preview only, or also update source code?

Highlight an object for debugging (wireframe or visibility toggle). Runtime only — for visual inspection, not persisted.

Debug only — page reload will reset. No code changes needed.

Execute arbitrary JavaScript with access to scene, renderer, camera. Returns the result. Runtime only (lost on reload). If the code mutates scene state, ASK the user first: runtime preview or persistent code change?

SHADER PATCHING RECIPE — when modifying materials via onBeforeCompile:

1. Reset patch flags: mat._curvedWorldPatched = false; mat._windPatched = false;

2. Delete old shader refs: delete mat.userData.shakeShader; stop old animations via mesh.userData._stopShake?.();

3. ONE onBeforeCompile pass (never chain) — include curved world + your effect together

4. Replace '#include <project_vertex>' with full transform: USE_BATCHING/USE_INSTANCING guards → effect in world space → curved world (worldPos.y -= dist²0.005) → viewMatrixworldPos → gl_Position

5. Declare uniforms before main(): shader.vertexShader.replace('void main() {', 'uniform float uTime;\nvoid main() {')

6. Set mat.customProgramCacheKey = () => 'effect-' + Date.now(); — forces recompilation

7. mat.needsUpdate = true;

8. Animate uniforms via requestAnimationFrame loop

9. Use transformed.y for height-based effects (local vertex Y), worldPos for spatial phase

Debug only — page reload will reset. No code changes needed.

Get detailed performance analysis: draw calls, triangles, instanced meshes, object counts by type

Inspect an InstancedMesh: count, max instances, geometry, sample transforms, custom attributes, instance colors

Modify InstancedMesh properties: count, visibility, frustumCulled — runtime-only preview (lost on reload). ASK the user first: runtime preview or persistent code change?

Runtime preview — lost on page reload. You MUST ask the user first: runtime preview only, or also update source code?

Get active camera properties: type, position, FOV, near/far, aspect

Modify camera: position, rotation, FOV, near/far, zoom — runtime-only preview (lost on reload). ASK the user first: runtime preview or persistent code change?

Runtime preview — lost on page reload. You MUST ask the user first: runtime preview only, or also update source code?

Get scene fog settings: type (Fog/FogExp2), color, near/far or density

Modify scene fog: color, near/far (Fog) or density (FogExp2), background color — runtime-only preview (lost on reload). ASK the user first: runtime preview or persistent code change?

Runtime preview — lost on page reload. You MUST ask the user first: runtime preview only, or also update source code?

Get renderer configuration: toneMapping, exposure, colorSpace, shadowMap, pixelRatio

Modify renderer: toneMapping, exposure, colorSpace, shadows — runtime-only preview (lost on reload). ASK the user first: runtime preview or persistent code change?

Runtime preview — lost on page reload. You MUST ask the user first: runtime preview only, or also update source code?

List all AnimationMixers, their actions, clips, weights, and playback state

Control animation: mixer timeScale, action play/stop/pause/weight. Runtime only — for testing.

Runtime preview — lost on page reload. You MUST ask the user first: runtime preview only, or also update source code?

List all skeletons/bones from SkinnedMesh objects in the scene

Inspect geometry: vertices, attributes, indices, bounding box, morph attributes

List all meshes with morph targets, their target names and current influence values

Set morph target influence on a mesh — runtime-only preview (lost on reload). ASK the user first: runtime preview or persistent code change?

Runtime preview — lost on page reload. You MUST ask the user first: runtime preview only, or also update source code?

Cast a ray from camera through screen coordinates and return hit objects

Show camera layer mask and objects with non-default layer assignments

Set layers on an object or camera — runtime-only preview (lost on reload). ASK the user first: runtime preview or persistent code change?

Runtime preview — lost on page reload. You MUST ask the user first: runtime preview only, or also update source code?

Add a visual debug helper to a scene object. Types: box, axes, skeleton, arrow, grid, polar_grid, camera, directional_light, spot_light, point_light, hemisphere_light, plane

Debug only — page reload will reset. No code changes needed.

Remove a previously added debug helper

Debug only — page reload will reset. No code changes needed.

Modify texture properties: wrap, filter, anisotropy, repeat, offset, colorSpace — runtime-only preview (lost on reload). ASK the user first: runtime preview or persistent code change?

Runtime preview — lost on page reload. You MUST ask the user first: runtime preview only, or also update source code?

Inspect shadow maps: global settings, per-light shadow config (bias, mapSize, camera frustum), cast/receive objects

Modify shadow settings — runtime-only preview (lost on reload). ASK the user first: runtime preview or persistent code change?

Runtime preview — lost on page reload. You MUST ask the user first: runtime preview only, or also update source code?

Inspect scene background, environment map (IBL), color management, backgroundBlurriness/Intensity

Search scene objects by type, material, visibility, name pattern, or custom property. Returns matching objects with details.

Detailed GPU memory analysis: geometry buffers, texture VRAM, instance data, top textures by size

Find potential memory leaks: orphaned geometries/textures not in scene but tracked by renderer, hidden objects with geometry

Toggle wireframe on all materials or a specific object. Runtime only — for visual debugging.

Debug only — page reload will reset. No code changes needed.

Show/hide axis-aligned bounding boxes for scene objects. Runtime only — for debugging frustum culling and object bounds.

Debug only — page reload will reset. No code changes needed.

Inspect environment maps: scene.environment, scene.background, per-material envMap, IBL settings

Compare scene state over time. First call saves a snapshot, second call shows what changed (added/removed/modified objects, transforms, materials, lights).

List post-processing passes from EffectComposer: render passes, shader passes, effects (bloom, SSAO, etc.)

Capture browser console output (log/warn/error). Returns last N messages. Call to check for runtime errors and warnings.

Preview a specific texture as a PNG image. Use texture_list first to find names/UUIDs.

Record FPS and frame times for N seconds. Returns avg/min/max FPS, percentiles, spike and jank counts.

Enable click-to-inspect mode. Cursor changes to crosshair — tell the user to click on an object in the 3D scene. Returns clicked object details.

Export scene or specific object as GLB. Requires GLTFExporter in your app (see error message for setup). Saves to screenshots/ folder.

Convert a GLTF/GLB file to a ready-to-use React Three Fiber component (like gltfjsx)

Capture a screenshot of the current Three.js scene

Screenshot with labeled object names overlaid at their screen positions. Shows [M]esh, [L]ight, [G]roup, [C]amera tags. Great for AI to understand scene layout visually.

Toggle a lightweight scene inspector overlay in the browser. Shows real-time FPS, draw calls, triangles, object count, scene tree, materials, and lights. Click objects in the tree to highlight them with wireframe. Debug only — page reload will reset.

Debug only — page reload will reset. No code changes needed.

Get comprehensive details about the object currently selected in the overlay. Returns full material properties, geometry info, transforms, textures, uniforms, shadow settings — everything needed to understand and modify the object in code. The user must first select an object in the overlay by clicking on it.

Check bridge connection and proxy status

Change the local dev server port the proxy forwards to

Connect to a remote Three.js app by URL for inspection and visual debugging. Source code changes are NOT possible in remote mode — only runtime/visual modifications.