Maintain GeoEngine Files - Nika

Updating GeoEngine

To update to the latest version, run:

geoengine update

GeoEngine detects how it was originally installed (Homebrew, curl, or PowerShell) and upgrades using the same method. After the binary is updated, it automatically runs geoengine patch to bring all workers, GIS plugins, and agent skills in sync with the new version. A typical update looks like this:

Detected install method: Homebrew
==> brew update
==> brew upgrade geoengine
==> Upgrading nikageospatial/geoengine/geoengine
  0.6.1 -> 0.6.4
==> Summary
🍺  /opt/homebrew/Cellar/geoengine/0.6.4: 4 files, 10.2MB, built in 1 second
GeoEngine updated via Homebrew

Running geoengine patch...
Checking global artifacts...
  ✓ settings.bin

Checking GIS plugins...
  ✓ QGIS plugin reinstalled (files were stale)
  • ArcGIS not installed on this machine — skipping

Checking agent skills...
  ✓ Claude skills up-to-date
  ✓ Codex skills up-to-date
  ✓ Antigravity skills up-to-date

Patch complete: 0 workers checked, 1 plugin updated, 0 skills synced,
               0 migrations applied, 0 issues found.

...

If the patch step reports that a GIS plugin was updated, restart QGIS or ArcGIS Pro to load the latest plugin version.

Patching GeoEngine

Sometimes, you might want to check on the integrity of GeoEngine artifacts. To do so, run:

geoengine patch

GeoEngine checks the integrity of all artifacts and reports any issues it finds.

Common Issues

Issue	Solution
Stale config files found	Run `geoengine delete` and `geoengine apply` again to reset worker cache.
Missing GIS plugins	Run `geoengine setup plugins`, then restart QGIS or re-add the ArcGIS toolbox.