Quick Start & Activation

1. Launch GDAgent

Double-click gdagent (or gdagent.exe on Windows) to open the installer.

2. Activate Your License

  1. Enter your license key (from your purchase email)
  2. Click Activate

3. Install to Your Project

  1. Select your project from the list
  2. Click Install

4. Open Godot

Open your project in Godot. You’ll see the GDAgent tab at the top.

5. Start Coding with AI

  1. Click the Add Your First Agent Tab button to open a new AI agent tab if you haven’t already
  2. Select your preferred AI tool
  3. Start working with your AI assistant

New terminals start from your current Godot project root, so the AI tool opens in the right local workspace. GDAgent can also surface bundled Godot MCP tools for supported agents, but that depends on the active tool and config.

License Management

Deactivate

Moving to a new machine? Free up the seat first:

  1. Launch gdagent
  2. Click Deactivate

Then activate on your new machine.

Offline Use

After activation, GDAgent works offline for up to 7 days. It revalidates automatically when you’re back online.

Activation Limits

Each license allows 2 simultaneous activations.

If you hit the limit, deactivate an old machine or contact support.

CLI Alternative

For automation or CI/CD, you can activate via command line:

gdagent activate

Or pipe the key via stdin:

printf '%s' "$GDAGENT_LICENSE_KEY" | gdagent activate

What’s Next?