CLI command design

installs

Discover local Altium Designer installs for diagnostics, launcher selection, and installer tooling.

Usage

altium-cruncher installs
altium-cruncher installs --json
altium-cruncher installs --install-root C:\Program Files\Altium

Arguments

--install-root adds a parent directory to scan for child install roots containing X2.exe. --json emits altium_cruncher.installs.a0 with install labels, major versions, roots, executable paths, runtime target framework, registry version, unique id, and discovery source.

Behavior

The command scans Program Files Altium roots, ALTIUM_AD*_ROOT environment overrides, and Windows Altium build registry rows when available. Results are deduplicated by resolved X2.exe path and sorted newest major version first.

Output

Human output is one line per discovered install. JSON output has schema altium_cruncher.installs.a0 and an installs array with path, version, registry, and source fields.

Tests

Unit tests create temporary AD25/AD26 roots with fake X2.exe files and verify deterministic sorting and version selection independent of machine-local installs.