Command-line interface

Stable commands

g2lex pack SOURCE OUTPUT --format FORMAT
g2lex lookup ASSET WORD
g2lex inspect ASSET
g2lex verify SOURCE ASSET --format FORMAT
g2lex export ASSET OUTPUT --format FORMAT
g2lex diff FIRST SECOND
g2lex convert SOURCE OUTPUT --input-format FORMAT --format FORMAT
g2lex --version

pack selects a source adapter and writes an exact .g2lex asset. lookup reads one value. inspect reports asset metadata. verify compares source and compiled content. export writes a supported source representation, and diff reports logical changes between assets. convert is a stable source-to-source conversion command; its --input-format and --format names follow the adapter contracts in source-formats.md.

Compatibility commands

restore is retained as a legacy compatibility command. It materializes exact G2LX assets and can also read older reduction assets; use export for stable exact G2Lex v1 workflows.

Commands return a non-zero status for invalid paths, formats, malformed input, incompatible assets, or failed exact comparisons. Error output is intended for humans and stable machine-facing report formats should be consumed through the explicit JSON options where provided.

Experimental commands

Reduction commands are intentionally marked experimental:

g2lex reduce SOURCE OUTPUT --format tsv
g2lex experimental verify-reduced SOURCE ASSET --format tsv

Reduction assets are not .g2lex exact v1 assets. Keep them behind an explicit experimental workflow and verify them with the corresponding command.