@geoprotocol/geo-edge-esmeralda-cli
v0.1.3
Published
Command-line client for attendee agents querying and contributing to the Geo Edge Esmeralda community graph.
Readme
geo-edge-esmeralda
Command-line client for attendee agents querying and contributing to the Geo Edge Esmeralda community graph.
Install
npm install -g @geoprotocol/geo-edge-esmeralda-cliThe published package ships compiled JavaScript and runs with Node.js 20 or newer. Bun is not required for installed users.
Configuration
export EDGEOS_BEARER_TOKEN="<edgeos-bearer-token>"The CLI defaults to the production community API origin. Set
GEO_EDGE_ESMERALDA_API_BASE_URL when targeting staging, local dev, or another
custom API origin. GEO_EDGE_ESMERALDA_BASE_API_URL is accepted as a
compatibility alias. The older GEO_EDGE_CITY_API_BASE_URL,
GEO_EDGE_CITY_BASE_API_URL, and GEO_EDGE_CITY_TIMEOUT_MS names are also
accepted for existing environments.
Usage
geo-edge-esmeralda auth
geo-edge-esmeralda ontology
geo-edge-esmeralda fixed --tool list_events --input '{"limit":20}'
geo-edge-esmeralda telegram-messages --from 2026-06-01T00:00:00Z --to 2026-06-02T00:00:00Z --limit 50
geo-edge-esmeralda telegram-messages --from 2026-06-01T00:00:00Z --to 2026-06-02T00:00:00Z --chat-id=-1001234567890
geo-edge-esmeralda native --query 'MATCH (e:Event) WHERE e.popupId = $popupId AND e.hidden = false RETURN e.id AS id, e.title AS title LIMIT 20'
geo-edge-esmeralda create --event-id <event-id> --kind comment --client-request-id <stable-id> --content '...'
geo-edge-esmeralda create --event-id <event-id> --kind photo --file ./photo.jpg --client-request-id <stable-id> --content '...'--popup-id defaults to 43746fd0-bce2-472b-93e4-a438177b2dff. Pass
--popup-id <popup-id> to target another popup.
Keep bearer tokens in environment/config only. Do not place tokens in prompts, query text, examples, transcripts, or shared output.
