GLX CLI Reference
The official command-line tool for working with GENEALOGIX (GLX) family archives. Use glx to initialize archives, import GEDCOM files, validate data quality, query entities, and analyze relationships.
The per-command pages linked below are auto-generated from the live Cobra command tree by make docs-cli. To change a command's documentation, edit its Use/Short/Long/Example strings in glx/cli_commands.go (or its *_runner.go file) and re-run the target. CI fails on any drift between the source command tree and the committed pages.
For installation instructions, see glx/README.md. For a guided walkthrough, see the Hands-On CLI Guide.
Commands
Archive Management
glx init— initialize a new archiveglx validate— validate files and cross-referencesglx split— convert a single-file archive to multi-fileglx join— convert a multi-file archive to single-fileglx merge— combine two archives with duplicate detectionglx migrate— migrate an archive to the current formatglx rename— rename an entity by ID
Import & Export
glx import— import a GEDCOM fileglx export— export to GEDCOM
Exploration
glx search— full-text search across entitiesglx query— filter and list entitiesglx vitals— show birth, death, burial for a personglx timeline— chronological events for a personglx summary— full person profile with narrativeglx ancestors— ancestor treeglx descendants— descendant treeglx cite— formatted citation textglx path— shortest relationship path between two people
Data Entry
glx census— census tooling (see subcommands)glx census add— generate entities from a census template
Analysis
glx stats— entity-count and confidence dashboardglx places— place data quality issuesglx cluster— FAN-club analysisglx analyze— gap, conflict, and suggestion analysisglx duplicates— detect duplicate entitiesglx coverage— research coverage reportglx diff— diff two archives
Shell completion
glx completion— generate shell completion scripts (bash, zsh, fish, powershell)