Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.geogen.io/llms.txt

Use this file to discover all available pages before exploring further.

​
GeoGen CLI

The GeoGen CLI is a terminal client for the GeoGen /v1 API. It lets you query LLM visibility data, manage entities and prompts, and inspect citations and competitors, all from a shell. The CLI is a thin wrapper over the same public API used by the dashboard and MCP server, so anything you can do with curl, you can do with geogen.
The CLI prints human-readable tables by default and supports --json on every command for piping into jq, scripts, or CI jobs.

​
Prerequisites

  • Node.js v18+ (check with node -v). Download Node.js if it’s missing.
  • A GeoGen API key. See Settings → Workspaces → Your Workspace → API Keys.

​
Install

​
Quick start

# 1. Authenticate (opens your browser, pick a workspace, click Authorize)
geogen login

# 2. Verify the connection
geogen workspace

# 3. List your tracked entities
geogen entities list

# 4. Inspect visibility for an entity
geogen trends visibility --entity ent_123 --period 7d
That’s it. Every other command follows the same shape: geogen <group> <verb> [--flags].
For scripts and CI where opening a browser isn’t an option, pass an API key directly: geogen login --api-key wsk_..., or set GEOGEN_API_KEY as an environment variable. See Authentication for all three modes.

​
Command map

Workspace

Usage, limits, credits, members, and tags

Entities

Create, list, update, delete tracked entities

Prompts

Add, update, delete tracking prompts

Name Requests

Submit and check entity name-change requests

Domain Groups

Group sibling entities under a single primary

Models

Browse available LLM models and their UUIDs

Responses

LLM responses with mention status

Citations

Top cited domains and per-domain URLs

Competitors

Competitor visibility leaderboard

Trends

Daily visibility, sentiment, and citation trends

Query Fanouts

Web search queries LLMs run while answering

Actions

Actionable recommendations and kanban tasks

​
Why a CLI?

  • Scriptable: drop geogen calls into any bash/PowerShell script or CI pipeline.
  • Pipe-friendly: pass --json and you get clean JSON for jq, yq, or any downstream tool.
  • No SDK lock-in: the CLI talks to the same /v1 REST API documented under Public APIs. You can swap to raw curl at any time.
  • Same auth model as MCP: your existing workspace API key works without any new setup.

​
Need help?

  • Run geogen --help or geogen <command> --help for inline reference.
  • See Authentication for credential storage and precedence.
  • See Global Options for flags that work on every command.
  • Email contact@geogen.io if you hit a wall.