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.
What you need
Section titled “What you need”- 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:ClaudePathorAiPrompt:CodexPathif 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).

Quick start
Section titled “Quick start”- 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.
- Choose Claude Code or Codex in the backend selector at the top.
- 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.
- 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.
Sessions
Section titled “Sessions”- 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).
What the assistant can use
Section titled “What the assistant can use”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-cliis 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.
Permissions
Section titled “Permissions”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.
Troubleshooting
Section titled “Troubleshooting”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.
See also
Section titled “See also”- Build a Twin with AI — example tasks, the connection check and the workflow with an external assistant
- AI Clients (MCP) — CONNECT tools and write-access settings