AI written
I'm tired and bad at writing things, help appreciated - file an issue or PR on GitHub.

Graphical interface

Use gui-for-cli when you want WGS Extract with windows, buttons, and forms.

The command-line app and graphical app are separate projects. Install wgsextract-cli when you want terminal commands and automation; install gui-for-cli from gui-for-cli Releases when you want a graphical interface for WGS Extract workflows.

GUI releases live in gui-for-cli

Download the WGS Extract graphical interface from the gui-for-cli Releases page. Use the latest gui-for-cli release for current installers, release notes, signatures, and metadata.

Use the release page when you want the newest platform packages, signatures, release notes, or older versions. The package names below describe what to choose on the latest release.

Choose a GUI download

Pick the package that matches your operating system. If you are unsure, open the latest gui-for-cli release and choose the asset recommended for your platform.

Checksums and signatures: gui-for-cli release assets include signature, appcast, and metadata files where the GUI build publishes them. Use the gui-for-cli releases page when you need to verify a package before installing.

Install the CLI option

Install wgsextract-cli when you want terminal commands, scripts, automation, remote-machine workflows, or an explicit wgsextract command that you can run outside the GUI.

The standalone macOS/Linux installer creates a self-contained wgsextract-cli/ folder with the wgsextract launcher beside it. Windows users should use the native install_windows.bat path from the install guide.

install-cli.sh
# Open Terminal, paste this line, then press Enter.
curl -fsSL https://raw.githubusercontent.com/theontho/wgsextract-cli/main/install.sh | sh

# Verify the CLI install.
./wgsextract-cli/wgsextract info --detailed
./wgsextract-cli/wgsextract deps check
Windows CLI: Clone or download wgsextract-cli, then run .\install_windows.bat from PowerShell. The Windows installer bootstraps Pixi and MSYS2 when needed and configures the native UCRT64 pacman runtime.

How the GUI and CLI fit together

The GUI and CLI are intentionally separate so each can ship on the cadence that fits its users.

Use the GUI for interactive work

Install gui-for-cli when you want a desktop-style app for selecting inputs, setting options, and running WGS Extract workflows without writing every command by hand.

Use the CLI for repeatable work

Install wgsextract-cli when exact commands matter: automation, batch runs, bug reports, AI-agent workflows, remote servers, and long-running whole-genome jobs.