CLI command design

extract

Extracts symbols, footprints, or project source contents from Altium design documents.

Usage

altium-cruncher extract schematic.SchDoc --combined -o output/extract
altium-cruncher extract board.PcbDoc --split -o output/extract
altium-cruncher extract project.PrjPcb -o output/extract
altium-cruncher extract vendor.IntLib -o output/extract

Arguments

file accepts schematic, PCB, project, and integrated-library inputs. Options select combined or split extraction and the output directory. For .IntLib, --stream-filenames uses IntLib stream basenames, --no-libpkg skips generated LibPkg, and --no-overwrite fails if extracted source files already exist.

Output

The command writes extracted SchLib or PcbLib artifacts, organized by source. .IntLib extraction writes source files under kind folders such as SchLib/ and PCBLib/, writes a generated LibPkg by default, and emits *_intlib_extract_manifest.json with stream paths, output paths, source kinds, and parse metadata.

Tests

L3 exercises schematic extraction on Hydroscope and IntLib source extraction on the redistributable RT_SUPER_C1.IntLib fixture. Planned corpus tests should mirror the broader underlying Altium Monkey extraction tests.