geo CLI is an operator tool for running the ai-cmo.dev measurement and analysis pipeline from the command line.
Installation
The CLI is a Python package. Install it from the repository:geo command via the pyproject.toml console script entry point:
How it works
The CLI runs locally against a checkout of the ai-cmo.dev repository. It reads brand configs from YAML files, runs prompts against AI engines, extracts mentions and citations, computes metrics, and generates reports. It does not call the ai-cmo.dev REST API — it works against SQLite databases and local files.Web app integration
The ai-cmo.dev web app invokes the CLI through a strict allowlist viaexecFile (never a shell). The allowed commands correspond to the token-authorized pipeline commands (run, extract, prompts generate, recs generate, research run, seo).
Who should use it
Most users should use the ai-cmo.dev dashboard or REST API. The CLI is designed for operators running the production pipeline, debugging, or developing new features.Key paths
Next steps
CLI commands
Complete reference for every geo subcommand and flag.
CLI configuration
Every environment variable the CLI reads.