The app downloads the Polychrome kernel on first launch, updates builds within a major version silently, and offers a new major version without forcing it.
Applies to: Agilelogin for Windows (first release); the macOS notes apply once the macOS build ships.
What happens on first launch?
The installer does not contain the browser kernel. The first time you open the app, it downloads Polychrome from releases.agilelogin.com, a download of a few hundred megabytes. The app reads a signed manifest, checks the archive’s SHA-256 checksum against it, unpacks the kernel into its own kernels\<build>\ directory and probes it once before any Profile can use it. If the checksum or the signature does not match, the build is discarded and the app says so.
While the download is running, the Profile list shows Kernel downloading with a percentage. If the download fails, the banner offers Retry.
Updates within a major version
Each Profile is bound to a kernel major version, which is the Chrome version websites see. New builds of that same major version, such as security fixes, are downloaded and installed in the background. The next launch uses the new build; a browser that is already running keeps the old one until you close it. The user agent does not change.
If the publisher withdraws a build, the app stops using it and tells you which build the Profile is running instead.
What happens with a new major version?
A new major version is offered in Settings → Kernels and next to the Profile list, and nothing is downloaded until you choose Download kernel N. Existing Profiles keep their kernel until you switch them, one at a time or in bulk with Switch kernel. Switching changes the browser version and user agent of those Profiles, so websites may ask you to verify again; kernels can only be switched to a newer version.
Each major version receives security updates for about 16 weeks after its release. After that it keeps working, but the app marks it as no longer receiving security updates and recommends switching.
The manual path
Settings → Kernels also accepts a kernel path. It is an escape hatch for development and advanced use: a kernel set by path is not signature-checked and is re-probed on every launch, and the settings page shows a standing warning while one is set. Clear the path to return to the downloaded kernels.
Unsupported machines
The app says so before downloading anything: This PC isn’t supported on Windows on ARM, and This Mac isn’t supported (requires Apple Silicon) on an Intel Mac.