AI Chat & Agent Mode

A full-featured AI chat panel in the right sidebar, powered by Claude (Pro) or GPT-4o mini (Free). Two modes give you flexibility: Ask for advice, or let the Agent build for you.

Chat modes

Ask mode

In Ask mode, the AI responds with explanations and code blocks. Each code block has a copy button so you can paste into your files. The AI does not modify your project in this mode.

Use Ask mode when you want to:

  • Understand how something works in Unity or Godot
  • Get code snippets to manually integrate
  • Debug an issue with guidance
  • Learn best practices for game development patterns

Agent mode

In Agent mode, the AI writes files directly to your project and executes bridge commands to create scenes, objects, and components in the running editor.

When the AI responds in Agent mode:

  • File code blocks are written to disk and shown as compact clickable file cards (created/updated status)
  • Bridge commands are extracted from the response and executed as a single batch request to the editor
  • Bridge results appear as collapsible cards with command results and a copy button
  • An Applying section shows animated progress with a timer and live activity lines during file writes and bridge execution

Chat features

Streaming

Responses stream in real-time with markdown rendering throttled at 600ms intervals for smooth display. The chat auto-scrolls during streaming and the applying phase.

Extended thinking

When the AI model uses extended thinking, a collapsible “Thought for Xs” section appears with a live timer. You can expand it to see the AI's reasoning process.

Phase indicators

The chat shows the current processing phase:

  1. Loading context - gathering project structure and skills
  2. Thinking - model is processing (with extended thinking timer if applicable)
  3. Responding - streaming the response
  4. Applying changes - writing files and executing bridge commands

File attachments

Attach files to your message in two ways:

  • Drag and drop files onto the chat input
  • @ mentions - type @ to open a file search popup, then select files to include as context

Stop button

Click the stop button during streaming to cancel the response mid-generation. Any files already written remain on disk.

Message persistence

Chat history is stored across sessions. When you reopen the IDE, your previous conversations are preserved.

How the Agent builds things

When you give the Agent a task like “create a player with movement”, here's what happens:

  1. The AI receives your project context (engine, scenes, scripts, assets) plus engine-specific skills
  2. It plans what files to create and what bridge commands to execute
  3. Scripts are written first (C# or GDScript files saved to your project)
  4. Bridge commands create the scene structure: nodes/GameObjects, components, property values
  5. All bridge commands from one response are batched into a single HTTP request to the editor for efficiency
  6. Results from each command are displayed as collapsible cards

Bridge connection behavior

The Agent works whether the bridge is connected or not:

  • Connected: Bridge commands execute in real-time. You see changes appear in the editor immediately.
  • Disconnected: Bridge commands are still included in the response and marked as pending. Files are still written. You can open the editor later and re-run the commands.

Content display in Agent mode

Agent mode cleans up the response for readability:

  • File code blocks are replaced with compact file cards showing the file path and status (created/updated/error). Click to open the file.
  • Bridge command JSON is hidden from the response body and shown separately as result cards.
  • The remaining text (explanations, instructions) is rendered as normal markdown.