Skip to content

AI prompt window

Ask an AI assistant to inspect your model, make edits or work with the simulation from the AI prompt window in the viewer. The window runs your own installed Claude Code or Codex command-line tool through CONNECT, with your own sign-in. The assistant works on the viewer tab that currently controls CONNECT.

  • Claude Code or Codex installed and signed in on the PC that runs CONNECT. The window offers each tool that is found and signed in. CONNECT searches PATH; set AiPrompt:ClaudePath or AiPrompt:CodexPath if a tool is installed elsewhere.
  • realvirtual CONNECT running on that PC. See CONNECT overview.
  • The prompt window enabled in CONNECT: in the CONNECT tray, open Details > MCP server and switch on Allow prompt window. The viewer shows this path while the window is off.
  • AI control on in the viewer, with the AI Bridge connected, for questions about the scene. See AI Assistant (Bridge).

The AI prompt window open over the viewer: the backend selector set to Claude Code, the Recent sessions list, the new-session and settings buttons, an empty conversation, the Scene access off line with its Enable scene access button, the prompt field with Send, and the Stop answer button

  1. Open the window with AI control in the viewer, or type a question in the search box and choose Ask AI agent. The first time, confirm the dialog with Got it.
  2. Choose Claude Code or Codex in the backend selector at the top.
  3. Check the scene-access line below the conversation. If it says Scene access off, click Enable scene access. Questions about the scene need it; general questions work without it.
  4. Type a prompt and press Enter (Shift+Enter inserts a new line). Try: “What is loaded in the viewer? Describe the top-level parts before making any changes.”

While the assistant works, its answer streams into the window and the actions it runs appear beneath it. If you send a prompt while scene access is off, the window keeps the prompt and offers Enable and send, Send without scene access or Edit prompt.

Your current selection in the viewer is attached to the prompt as a chip. Remove the chip to leave the selection out of the next prompt.

  • Recent sessions lists earlier conversations. Choose one to continue it; earlier messages are not shown again.
  • The + button starts a new session. Switching the backend also starts a new session.
  • Show AI clicks animates the buttons the assistant presses. Turn it off for fast mode, without waiting before each action.
  • The settings button opens the AI settings, including AI may control SolidCraft (see below).

Each run sees only the tools that realvirtual provides:

  • realvirtual-CONNECT: the web_* tools of the active viewer tab.
  • SolidCraft: only when AI may control SolidCraft is on, the Live Link is connected and solidcraft-cli is found.

MCP servers, plugins and apps from your own Claude Code or Codex configuration are not loaded in this window, and for Codex your own model settings do not apply. Use your normal terminal session if you need those.

The window does not ask for approval per tool call. The tool runs with full rights on the CONNECT PC, which is why a person must switch on Allow prompt window in the CONNECT tray first. Existing CONNECT write restrictions and the AI control switch of the viewer still apply.

  • Only one prompt runs at a time.
  • Click Stop answer to interrupt a run. A call that is already running may still finish; stopping does not undo changes.
  • A run ends after 30 minutes at the latest.
  • Use the editor’s undo for individual changes. There is no undo for a whole prompt.

Prompts, tool results and attached images go to the AI service of the selected tool (Anthropic for Claude Code, OpenAI for Codex) through your own sign-in.

The window is not offered, or a backend is missing. Check that Allow prompt window is on in the CONNECT tray, that claude --version or codex --version works in a terminal on the CONNECT PC, and that the tool is signed in. A tool that is too old is reported as not supported.

“This viewer origin is not allowed”. Pair the viewer in CONNECT and review the AI settings. The button in the window opens them.

Scene access: another tab is in control. One viewer tab controls CONNECT at a time. Use that tab or close it. See Document ownership.

“Another AI prompt is already running”. Wait for the current run or click Stop answer.