CLI Reference

Synopsis

gdagent [--json] [--help] [--version] [subcommand]

Without a subcommand, gdagent launches the GUI manager.

Commands

• install - Install GDAgent addon to a Godot project
• uninstall - Uninstall GDAgent addon from a Godot project
• list-projects - List detected Godot projects
• status - Show GDAgent installation status for a project
• activate - Activate a license key
• deactivate - Deactivate the current license from this machine
• doctor - Run diagnostic checks and generate support report
• manpage - Generate a man page for gdagent
• repair - Repair an existing GDAgent installation

For command-specific flags and arguments:

gdagent <command> --help

JSON Output

--json is supported for machine-readable output on CLI workflow commands.

Automation Example

- name: Activate and install GDAgent
  env:
    GDAGENT_LICENSE_KEY: ${{ secrets.GDAGENT_LICENSE_KEY }}
  run: |
    printf '%s' "$GDAGENT_LICENSE_KEY" | gdagent activate
    gdagent install -p ${{ github.workspace }}