Table of Contents

Set up the AI Workflow

Open the AI Workflow page with Window > Vista > AI Workflow, then follow its numbered steps. A checkmark appears beside each step that is done. Check the requirements first.

alt text

  1. Install the Unity CLI. Select Open Unity's Installation Guide, or follow Unity's guide Use the Unity CLI. When you come back to the Editor, the page detects the CLI, even when you installed it from a terminal after Unity started.

  2. Install the Unity Pipeline package. Select Open Unity's Installation Guide, or follow Unity's guide Unity Pipeline package.

  3. Turn on the AI Workflow. Select Turn On. Unity recompiles scripts, and the step changes to AI Workflow is on.

  4. Set up your agent. Copy the message on the page and send it to your agent once:

    Run "unity command vista_agent_setup" to set up Vista for this project.
    
  5. Build your terrain together. Tell the agent your idea, then ask for changes until it is finished.

Step 4 writes a short Vista section into AGENTS.md at your project root, which Codex and similar agents read at the start of every session, and makes CLAUDE.md include it, for Claude Code. Every new agent session then starts knowing how to use Vista. Only the marked Vista section is written; the rest of both files is kept. Run it again after updating Vista to refresh that section.

Turn it off

Select Turn Off on the AI Workflow page. Unity recompiles scripts, and Vista works as it did before. Your terrain, graphs, and Scene Pins are kept.

Turning the workflow on adds the VISTA_ENABLE_AI scripting define to every installed build platform, and turning it off removes it.

Troubleshooting

The agent says there are no Vista commands. The AI Workflow is off, or the Unity Pipeline package is missing. Open the AI Workflow page and check steps 2 and 3.

Vista stops compiling after a Unity Pipeline update. Pipeline is experimental, and an update can change what Vista relies on. Select Turn Off on the AI Workflow page. If the page does not open, open Project Settings > Player > Scripting Define Symbols and remove VISTA_ENABLE_AI. Then check for a Vista update that supports the new Pipeline version.

The agent seems stuck. Look for an open Unity dialog that is waiting for an answer.