April 10, 2026Geocodio now has a CLI (and your AI coding assistant can use it too!)
Geocodio now has a command-line interface for geocoding, batch processing, and AI assistant integration.
If you've ever wanted to geocode an address without leaving the warm embrace of your terminal, good news: Geocodio now has a command line interface with a corresponding agent skill.
curl -fsSL https://raw.githubusercontent.com/geocodio/geocodio-cli/main/install.sh | sh
export GEOCODIO_API_KEY=your-api-key
geocodio geocode "1600 Pennsylvania Ave NW, Washington DC"
Geocoding right from your terminal
The CLI covers the full Geocodio API: geocode addresses, reverse geocode coordinates, calculate distances, run distance matrices, and process spreadsheets in batch. Append data fields like timezone, congressional districts, and census data. All from the coziness of your terminal.
# Batch geocode a file of addresses
geocodio geocode --batch addresses.txt
# Calculate driving distances to multiple destinations
geocodio distance "Washington DC" "New York" "Boston" --mode driving
# Upload a spreadsheet for processing
geocodio lists upload data.csv --direction forward --format "{{A}}, {{B}}, {{C}}"
Output comes in three formats: human-readable (with colors, because terminals deserve nice things), JSON for scripting, and markdown for AI agents.
Geocoding within Claude, Copilot, and more
The CLI ships with a skill that teaches AI coding assistants how to use Geocodio. It works with Claude Code, Cursor, Amp, Codex, and anything else that supports skills.
npx skills add geocodio/geocodio-cli
Once installed, your assistant knows every CLI command, batch processing workflows, data append fields, and common multi-step patterns. Just ask it to geocode something and it figures out the rest.
Get started
The CLI is open source and available on GitHub. You'll need a Geocodio API key, which you can get for free here if you don't already have one (2,500 free lookups per day, no credit card required).
If you run into anything unexpected, please feel free to reach out.