Skip to main content

CLI Reference

The eider CLI is a spatial data engine for GeoZarr and DuckDB. It works two ways:

  • Interactive (TUI): run a command with missing inputs and it prompts you with menus (provider/collection pickers, resampling options, plot types, …).
  • Agent / scripting: pass --output=json for machine-readable output and fully non-interactive behavior.

See Installation to get the CLI.

Global options​

OptionDescription
--output tableHuman-readable output (default).
--output jsonMachine-readable JSON; suppresses interactive prompts (required inputs must be passed as flags).

In JSON mode, every command emits a status envelope. On failure:

{ "status": "error", "message": "<what went wrong>" }

On success the shape depends on the command (documented per page).

Commands​

CommandPurpose
infoInspect a Zarr array's metadata.
searchDiscover GeoZarr/COG assets via a STAC API.
extractExtract array data intersecting vector polygons into DuckDB.
ingestConvert a legacy file (NetCDF/GeoTIFF/CSV) to GeoZarr.
exportWrite a DuckDB query result out to a Zarr array.
resampleTemporally resample extracted data.
plotRender an ASCII plot from a DuckDB file.
shellOpen a DuckDB shell preloaded with the extension.
completionsGenerate shell completion scripts.

For end-to-end workflows that chain these commands, see the Guides section.