@embed-earth/cli-test

@embed-earth/cli-test

The e2 command-line interface for Earth feature search, cache management, Valhalla routing, cloud/local compute, and geospatial storage.

Product: embed.earth · Docs: CLI docs · Docs home

Related interfaces: SDK docs and MCP docs.

The CLI is the terminal interface to the same capabilities exposed by the @embed-earth/sdk-test SDK and the @embed-earth/mcp-test MCP server.

Install

Route commands use https://ov-valhalla.fly.dev by default. Set VALHALLA_URL to override the raw Valhalla service, or set E2_API_KEY and optionally E2_ROUTING_URL to use authenticated hosted routing.

npm install -g @embed-earth/cli-test
earth search restaurant --area Manhattan --limit 100
earth cache set 5GB
earth compute count restaurant --db ./e2.db --near park --distance 500
earth storage upload ./places.geojson --db ./e2.db --connect-to restaurant
earth map sources restaurant hospital

Cell encode/decode and catalog commands are also retained. Use earth --help for the complete command tree. map sources returns MapLibre-ready Planet and published feature PMTiles sources.

Command layout

Group	Commands	Purpose
Search	earth search	Search features and return GeoJSON
Cache	earth cache set, list, delete, clear	Manage downloaded snapshots
Route	earth route run, matrix, isochrone, map-match, to-feature, request	Routing and network analysis
Compute	earth compute <primitive>, compare	Cloud, cached, or local spatial analysis
Catalogs	earth features, regions, datasets	Discover and resolve catalog entries
Storage	earth storage upload, import, import-file, query, stats	Work with local datasets
Map	earth map sources	Resolve MapLibre-ready sources
Cells	earth cell encode, decode, neighbors, and parent/temporal helpers	Work with E2 cells

Common options

Option	Meaning
--json	Emit machine-readable JSON
--area <name>	Use a named area
--area-id <id>	Use an exact area ID
--mode <cloud|offline|auto>	Select the search or compute backend
--db <path>	Use a local SQLite database
--limit <number>	Bound returned rows

Use --area for a human-readable name or --area-id for an exact catalog ID. You can search available regions and search available features before running a command.

Open-source foundation

The CLI keeps the interface small by composing open-source tools and the EmbedEarth SDK:

Tool	Role in the CLI
Commander	Command parsing, options, and help output
DuckDB	Local analytical query support
SQLite	Local snapshot and user-data storage
GeoParquet	Portable geospatial upload output
EmbedEarth SDK	Shared search, route, compute, catalog, and map clients

For the equivalent agent-facing interface, see the MCP package. For typed application integrations, see the SDK package.