Docs/Getting Started/Getting Started

Getting Started

Dynamo Engine is a desktop app. Install it, sign in, connect your AI and open your game. The first run walks you through it in four short steps.

1. Install the App

  1. 1.Download the installer for macOS or Windows.
  2. 2.Run it.
  3. 3.Open Dynamo Engine.

2. Sign In

  • ●New here? Start free trial opens the website to create your Dynamo Engine account. Your 7-day Personal trial starts when you first sign in to the app; no card needed. When you're done, come back and press Sign in.
  • ●Already have an account? Sign in with existing account opens your browser, and the app updates on its own when you're done. If the browser doesn't open, you can sign in with a code sent to your email instead.
The first-run sign-in step in Dynamo Engine, with Start free trial and Sign in with existing account

3. Connect a Model

Pick one. You can add more later in Settings → Providers.

  • ●Paste a provider key — an API key for Anthropic, OpenAI, Google, xAI or OpenRouter. Get key ↗ goes to the provider's key page.
  • ●Use a model on this computer — Ollama, when it's running. No key needed.
  • ●Your own endpoint — any OpenAI-compatible provider, under Settings → Providers → Your own endpoint.
The first-run Connect a model step, with a subscription, a provider key, or a model on this computer
Subscriptions — experimental. The app can also use a Claude or Grok subscription you already pay for. This connection is experimental: Anthropic and xAI control which plans work and on what terms, and that can change at any time. For guaranteed access, use an API key. If Grok stops answering, open a new Terminal window, type grok update and press Enter, then send your message again.

4. Point at Your Game

Press Open a project… and pick the folder your game is in. Dynamo reads it; it doesn't move anything.

The first-run Point at your game step, with the Open a project button

5. Add Dynamo to Unity

Dynamo adds its Unity package to the project and shows *Adding Dynamo to this Unity project…* while it works. If it asks first, press Install & open. If it says *Couldn't add Dynamo to this Unity project.*, press Retry.

The line above the chat box reading Adding Dynamo to this Unity project

Then open the project in Unity. If it was already open, it picks the package up without a restart. Dynamo pilots the editor from outside, so keep Unity open while you work. See Unity Integration for more.

Your First Chat

Type what you want in the box (*Ask Dynamo to build, fix, or explain something…*) and press Enter.

  • ●Every step shows in the chat. Open one to see what it asked for and what came back.
  • ●Review the changes. When it's done, Show changes lists every edit. Keep or Undo each file or each change.
  • ●Commit and open a pull request by asking Dynamo in the chat, after you sign in to GitHub under Settings → Integrations.
A finished chat turn with one step opened, and the changes panel with Keep and Undo for each file

Ask First or Auto Mode

The Mode chip in the composer sets how much Dynamo asks before it acts:

  • ●Ask first — Reads run on their own. Dynamo asks once per model before it makes a change, and every time before anything risky.
  • ●Auto Mode — Changes run without asking. Dynamo still asks before it touches protected files like .env or keys, restores or deletes a checkpoint, stops a job, turns a skill back on, force-pushes to a protected branch you allowed, and during a compile-error cascade. Blocked commands never run.

The chip applies to that chat. New chats start from your default, set in Settings → Permissions → Where new chats start.

Switch Models

The model button in the composer switches models at any time, mid-chat included. Effort in the same menu sets how hard the model thinks. A change applies from the next message.

Chats and Projects

  • ●New chat (⌘N, or Ctrl+N on Windows) starts a fresh chat. Your earlier chats are in the sidebar; click one to pick it up again.
  • ●To switch projects, click the project name at the top of the sidebar: Recent, Open a project… or New project…. New project… makes a Unity project from a name, a Unity version and a template, adds Dynamo to it and opens it.

Next Steps

  • ●Unity Integration — how Dynamo pilots the Unity editor from outside
  • ●Accounts & Plans — your account, devices and billing
  • ●Advanced: command line — Dynamo also runs from the command line; its commands, flags and config files are covered at the end of the documentation