open

<h1 align="center">Limelit Open</h1> <p align="center"> <strong>Self-hosted AI visibility tracking. One binary, your keys, your data.</strong> </p> <p align="center"> Track how ChatGPT, Claude, Perplexity, Gemini, Google AI Overview and Google AI Mode <br /> mention and cite your brand against your competitors, with an MCP server for AI visibility tracking built in. </p> <p align="center"> <a href="LICENSE"><img alt="License: Apache 2.0" src="https://img.shields.io/badge/license-Apache--2.0-blue.svg"></a> <a href="go.mod"><img alt="Go 1.25+" src="https://img.shields.io/badge/go-1.25%2B-00ADD8.svg?logo=go&logoColor=white"></a> <a href="#status"><img alt="Status: pre-release" src="https://img.shields.io/badge/status-pre--release-orange.svg"></a> <a href="https://limelit.co"><img alt="Limelit Cloud" src="https://img.shields.io/badge/hosted-limelit.co-111.svg"></a> <a href="https://discord.gg/g2Ef3WSTTC"><img alt="Discord" src="https://img.shields.io/badge/chat-Discord-5865F2.svg?logo=discord&logoColor=white"></a> </p> https://github.com/user-attachments/assets/b5894a6e-bb40-426d-b493-2cedc7e41e90 <p align="center"> _{The launch film, 44 seconds with sound. Also on <a href="https://limelit.co/open">limelit.co/open</a>, or <a href="docs/video/limelit-open-launch.mp4">download the MP4</a>.} </p> <p align="center"> <a href="https://demo.limelit.co"><img alt="The race: every tracked brand's visibility by day, with a hover card for one measured day" src="docs/screenshots/race.png" width="880"></a> </p> <p align="center"> <a href="https://demo.limelit.co"><img alt="Visibility by engine: every brand as a dot on a shared 0 to 100 track, one row per engine" src="docs/screenshots/by-engine.png" width="435"></a> <a href="https://demo.limelit.co"><img alt="Share of voice donut with the seven leading brands named and the rest grouped" src="docs/screenshots/share-of-voice.png" width="435"></a> </p> <p align="center"> <strong>Live: <a href="https://demo.limelit.co">demo.limelit.co</a></strong> runs this repository unmodified. Read-only; the banner names the commit. <br /> _{More screens below: the prompt by engine grid, the ranking, citations by source type, top cited sites, and visibility by question type.} </p> --- Also known as **AEO** (Answer Engine Optimization), **GEO** (Generative Engine Optimization), **AIO** (AI Search Optimization) and **LLMO** (LLM Optimization). They are four names for the same question: when someone asks an AI assistant about your category, does your brand come up, and which sources does the answer trust? Limelit Open answers that on your own infrastructure. It is the open core of [Limelit](https://limelit.co), and it shares its tool names, engine ids and metric definitions, so moving to the hosted product is one command. ## Contents - [Status](#status) - [Screenshots](#screenshots) - [Why this exists](#why-this-exists) - [Features](#features) - [Quick start](#quick-start) - [Connect Claude (MCP)](#connect-claude-mcp) - [Claude plugins and skills](#claude-plugins-and-skills) - [Engines and providers](#engines-and-providers) - [Configuration](#configuration) - [How the numbers are computed](#how-the-numbers-are-computed) - [Cost](#cost) - [Compared with other AI visibility tools](#compared-with-other-ai-visibility-tools) - [Hosted only](#hosted-only) - [Glossary](#glossary) - [FAQ](#faq) - [Roadmap](#roadmap) - [Development](#development) - [Contributing](#contributing) - [License](#license) ## See it running **[demo.limelit.co](https://demo.limelit.co)** is this repository, unmodified, tracking a GPU cloud vendor against 21 competitors across six engines. The banner names the commit it runs. It is read-only. The history is a real company's data with the brand renamed to NorthWind, so the numbers are real measurements and the engines' answers are the ones they actually gave. ## Status **Pre-release. v0.1 is being built in the open.** What works today, verified against a live instance: - **One binary.** No Docker, no Node, no Postgres. It creates and migrates its own SQLite database on first start and serves the dashboard at `localhost:1515`. - **All seven engines.** ChatGPT, Claude, Perplexity and Gemini through their vendor APIs with web search on; Google AI Overview, Google AI Mode and Bing Copilot through scrapers, because those three have no API at all. Six providers of eleven are implemented; Settings lists the rest with a link to each key page. - **The full measurement chain.** Answers are stored, searched for your brand and every tracked competitor with the rank of the list item they appear in, and every cited source is classified as your own, a competitor's, social, informational or other. - **The numbers, on screen.** Visibility, share of voice, average position and citation share, each with the sample it rests on; the competitor ranking; the trend; visibility split by question type; and the prompt by engine grid. - **The evidence behind them.** Every answer readable in full with your brand marked in the text at the matcher's own offsets, the searches the engine ran on the way there, the brands it named with their ranks, and every source it cited. - **MCP.** `limelit mcp` over stdio, or streamable HTTP with a bearer token. Fourteen read tools on Limelit Cloud's names, so a conversation written against this server keeps working after an upgrade. The first one an assistant calls says where the instance stands (not set up, never run, ready) and what to do next, so a new user is never handed a 0%. - **Scheduling.** Daily or hourly inside `limelit serve`, or `limelit run` for one pass on demand, with a hard `runs_per_day` ceiling checked before any spend. - **Export.** `limelit export` writes the whole instance as one JSON document or a directory of CSVs, streaming, with a `--since` filter that reaches the rows hanging off each answer. `export_data` returns the same payload over MCP. - **Upgrade.** `limelit upgrade --key <cloud key>` uploads everything to a Limelit Cloud workspace and hands back its MCP endpoint. Nothing is deleted here, provider keys are never sent, and re-running after a dropped connection imports nothing twice. What does not work yet: five of eleven providers are unbuilt. Everything else in the table below is live. Everything marked *planned* below is tracked in [issues](https://github.com/limelit-co/open/issues) under the [v0.1 milestone](https://github.com/limelit-co/open/milestone/1). Watch releases to hear when it ships. ## Screenshots All taken from [demo.limelit.co](https://demo.limelit.co). Every number carries the sample it rests on, and every chart is server-rendered SVG that reads without JavaScript; hover adds detail, it never adds a value. <table> <tr> <td width="50%"><a href="docs/screenshots/grid.png"><img alt="Every prompt, every engine: a grid of fractions, worst prompts first, each cell a link to the answers behind it" src="docs/screenshots/grid.png"></a></td> <td width="50%"><a href="docs/screenshots/standings.png"><img alt="Where you stand: every tracked brand ranked by how often it is named, with share of voice and average position" src="docs/screenshots/standings.png"></a></td> </tr> <tr> <td>_{<strong>Every prompt, every engine.</strong> A fraction per cell, worst first. A dash is a prompt never asked of that engine, not a zero.}</td> <td>_{<strong>Where you stand.</strong> The ranking, with the mention and answer counts each rate rests on.}</td> </tr> <tr> <td><a href="docs/screenshots/who-gets-cited.png"><img alt="Who gets cited: one 100 percent stacked bar per measured day, split by source type, your share printed above each" src="docs/screenshots/who-gets-cited.png"></a></td> <td><a href="docs/screenshots/top-cited-sites.png"><img alt="Top cited sites, each classified as own, competitor, social, informational or other" src="docs/screenshots/top-cited-sites.png"></a></td> </tr> <tr> <td>_{<strong>Who gets cited.</strong> Each bar is one measured day's citations by source type; the number on top is your share.}</td> <td>_{<strong>Top cited sites.</strong> The pages the engines trust, classified. These are the pages you have to appear on or displace.}</td> </tr> <tr> <td><a href="docs/screenshots/by-question-type.png"><img alt="Visibility by question type: self-service, governed, GPU-first, sovereign-ready, multi-tenant, each with its own denominator" src="docs/screenshots/by-question-type.png"></a></td> <td><a href="docs/screenshots/race.png"><img alt="The race with a hover card listing every brand's value on one measured day" src="docs/screenshots/race.png"></a></td> </tr> <tr> <td>_{<strong>By question type.</strong> A question that names a rival lists rivals by construction, so each type is scored on its own.}</td> <td>_{<strong>The race.</strong> Calendar-proportional: a span nobody measured is shaded, never curved across. Hollow dots rest on thin samples.}</td> </tr> </table> ## Why this exists Most AI visibility platforms are closed SaaS. You send them your prompts, they send you a number, and how that number was computed is theirs. That is an awkward trade for a metric you are going to put in a board deck. Limelit Open takes the other side of it: - **Your infrastructure.** Prompts, competitors and every answer live in a SQLite file you own. Nothing leaves the box except the calls to the engines (made through Limelit Cloud when you use the free allowance). - **Your keys, your bill.** Bring your own provider keys. There is no pricing, no credits and no markup anywhere in this project, and no per-seat tax on looking at your own data. To try it first without buying any key, a free Limelit Cloud account gives a monthly allowance (see below). - **Auditable by construction.** Mentions are found by text search, not by a model deciding what it saw. Every metric is derived from stored rows and can be recomputed. The formulas are below and the code is right here. - **Honest about what is measured.** An answer from a vendor API with web search on is not the answer a person sees in ChatGPT. Both are useful, they are different surfaces, and every number carries which one it came from. ## Features | Feature | Status | |---|---| | **Visibility tracking**: how often each engine mentions your brand, per prompt and over time | **working** | | **Share of voice**: your mention rate next to every tracked competitor, on the same prompts | **working** | | **Citation analysis**: every URL an answer cited, classified as your own, a competitor, social, informational or other | **working** | | **Prompt by target grid**: one cell per prompt and engine, click through to the answers behind it | **working** | | **Hybrid providers**: vendor APIs and consumer-surface scrapers behind one interface, labeled on every metric | **6 of 11, all seven engines** | | **MCP server**: stdio and streamable HTTP, so Claude can read your visibility data and answer in plain language | **working** | | **Dashboard**: embedded in the binary, no Node, no separate frontend to deploy | **working** | | **Evaluation runner**: every active prompt against every enabled target, with usage counters and a hard `runs_per_day` ceiling | **working** | | **Scheduler**: daily or hourly in `limelit serve`, or `limelit run` for one pass on demand | **working** | | **Export**: JSON or CSV of everything, the same payload the Cloud upgrade sends | **working** | | **One-command upgrade**: move your property, prompts and history to Limelit Cloud | **working** | | **Query fan-out**: the searches an engine actually ran on the way to its answer, which are often not the question you asked | **working** | | **Setup wizard**: brand, competitors, a starter prompt pack from your category, one key | **working** | | **Single binary, SQLite**: no cgo, no Docker requirement, no Postgres | **working** | ## Quick start Ten minutes from nothing to a first number, in four steps, on macOS or Linux. Nothing to install first. ### 1. Download and start ```bash mkdir -p ~/limelit && cd ~/limelit curl -fsSL https://github.com/limelit-co/open/releases/latest/download/limelit_$(uname -s | tr A-Z a-z)_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz | tar xz limelit ./limelit serve ``` Then open <http://localhost:1515>. The download is the newest build for your system, one file, `limelit`, in `~/limelit`. On start it prints every way to connect: the browser address, and lines for Claude Code, Claude Desktop and any other MCP client with your paths already filled in. The database is one SQLite file in `~/limelit/data`; back it up by copying it. Every build and its checksums are on the [releases page](https://github.com/limelit-co/open/releases). The same binary two other ways: ```bash # With Go 1.25 or newer go install github.com/limelit-co/open/cmd/limelit@latest limelit serve # With Docker; the database lives in the limelit volume docker run -p 1515:1515 -v limelit:/data ghcr.io/limelit-co/open ``` ### 2. Set up in the browser The setup wizard asks for your domain and reads your brand's name from your own site (answers write "Kindle to PDF", not "kindletopdf.com"), then your category and up to five competitors, fills a starter set of prompts, and takes one key. Two ways: - **Free:** open <https://limelit.co/settings/open-key>, sign in with Google, press Create my key and paste it into the wizard. Or, in a second terminal, run `limelit login` (from the same folder as `limelit serve`), which opens that page and saves the key for you. It reaches ChatGPT, Gemini, Perplexity and Google's AI Overviews and AI Mode inside a free monthly allowance. Your prompts pass through Limelit Cloud to reach the engines; the answers are stored here. - **Your own keys:** the quickest is OpenAI's, which reaches ChatGPT. Settings lists every other provider with a link to where its key comes from. You pay them directly, with no limit from us. If you already track this brand on Limelit Cloud, the prompts step offers to import your Cloud prompts and competitors instead of the starter set (the Prompts page has the same button later). After a run, the Competitors page suggests the sites your answers cite most. Nothing is spent before you press Run. When the free allowance runs out, the failed answers say so; add your own key to keep going. ### 3. Press Run One pass asks every prompt of every tracked engine. Answers appear on the Overview as each engine replies, usually inside a minute. Every number shows `n`, the answers it rests on, and under 20 says so. ### 4. Connect Claude Claude Code: ```bash claude mcp add limelit -s user -- sh -c 'cd ~/limelit && exec ./limelit mcp' ``` Claude Desktop, in `claude_desktop_config.json`: ```json { "mcpServers": { "limelit": { "command": "sh", "args": ["-c", "cd ~/limelit && exec ./limelit mcp"] } } } ``` `~/limelit` is where step 1 put `limelit`. Claude starts `limelit mcp` in that directory so it reads the same `data` folder as the dashboard. If you put `limelit` somewhere else, change `~/limelit` to that directory, or copy the lines `limelit serve` prints, which carry your exact paths. Then ask: "Get started with Limelit". You never need a tool name: the assistant checks where your instance stands, tells you the next step if setup or a first run is missing, and otherwise answers with your numbers and questions to ask next. Or go straight to "How visible is my brand in AI answers, and which prompts am I losing?" The tools are the same ones the dashboard reads, so the assistant's number is the screen's number. From here, [Configuration](#configuration) covers the file and the environment, [Connect Claude (MCP)](#connect-claude-mcp) the remote endpoint and the tool catalog, and [docs/methodology.md](docs/methodology.md) what every number means. ### Commands ``` limelit serve dashboard, JSON API, MCP over HTTP, and the scheduler limelit mcp MCP over stdio, for Claude Desktop and Claude Code limelit run one evaluation pass, then exit limelit export write everything this instance knows to stdout limelit login get a free Limelit Cloud key and save it here limelit upgrade move this instance to Limelit Cloud limelit version version and build info ``` ## Connect Claude (MCP) Limelit Open is MCP-first. The dashboard shows you the numbers; the MCP server lets an assistant read them, cross-reference them and quote the evidence. It can also start a run: it shows you the plan first, and runs only after you say yes. Claude Desktop or Claude Code, over stdio, set up as in [step 4 of the quick start](#4-connect-claude). `limelit mcp` reads `./data` in the directory it starts in, so it has to start where `limelit serve` runs, or be told the directory with `LIMELIT_DATA_DIR`. Started anywhere else it opens an empty database, not your instance. Remote clients point at `limelit serve` and its streamable HTTP endpoint at `/mcp`, sending a bearer token as `Authorization: Bearer <token>`. Generate the token in Settings (it is shown once and stored encrypted; Rotate and Forget take effect on the next request, no restart), or set `LIMELIT_MCP_TOKEN`, which wins over a generated one. Until a token exists the endpoint refuses every request: an open MCP endpoint would hand anyone who can reach the port every answer you have stored. Then ask things like: - "Get started with Limelit" - "How is Acme doing across AI engines this week?" - "Which prompts are we losing to Globex, and what do those answers cite instead of us?" - "Show me the answers behind our visibility drop, with the exact quotes." - "What did the engines actually search for when they answered that prompt?" Every metric a tool returns carries `n`, the answers it rests on, and the `api` or `scraped` access mode of each target. Arguments that only exist in Limelit Cloud, such as `segment`, are rejected with an explanation rather than silently ignored: a number scoped differently from what you asked for is worse than an error. Tool names mirror Limelit Cloud, so a conversation or a skill written against this server keeps working after you upgrade. Full catalog: [docs/tools.md](docs/tools.md). ## Claude plugins and skills This repository is also a Claude plugin marketplace. Add it once, then install the plugins you want: ``` /plugin marketplace add limelit-co/open /plugin install limelit-open@limelit ``` In the Claude desktop app or Cowork: **Plugins**, then **+ Add**, then **Add marketplace**, and enter `limelit-co/open`. | Plugin | What it does | |---|---| | [`limelit-open`](plugins/limelit-open) | Connects this install over stdio, with the skill `limelit-open-visibility-report`. Claude asks for the binary path and the data directory. | | [`limelit-audit`](plugins/limelit-audit) | Two skills that need no install and no account: `ai-crawler-check` (which AI crawlers a robots.txt lets in, and what each block costs) and `llms-txt-check` (audits a site's llms.txt and drafts a better one). | | [`limelit`](plugins/limelit) | Connects Limelit Cloud instead, with a Cloud API key. | Details and privacy notes: [plugins/README.md](plugins/README.md). ## Engines and providers A **target** is one way of asking one engine, written `engine:provider[:model][:online]`: ``` chatgpt:openai:gpt-5.5:online ChatGPT's model through OpenAI's API, web search on chatgpt:dataforseo:online chatgpt.com as a user sees it, through a scraper claude:anthropic:online perplexity:perplexity:sonar gemini:google:online ai_overview:dataforseo ai_mode:dataforseo bing_copilot:searchapi ``` Two targets can point at the same engine. They are tracked separately and never averaged together, because they measure different things. **Engines**: `chatgpt`, `claude`, `perplexity`, `gemini`, `ai_overview`, `ai_mode`, `bing_copilot`. **Providers**: | Access | Providers | What it measures | |---|---|---| | `api` | `openai`, `anthropic`, `perplexity`, `google`, `openrouter` | The vendor's model with web search enabled, billed per token | | `scraped` | `dataforseo`, `searchapi`, `cloro`, `brightdata`, `oxylabs`, `olostep` | The consumer surface a person actually sees, billed per request | Adding a provider is one HTTP call, one response parse and a fixture, against a small Go interface. See [docs/providers.md](docs/providers.md); the open adapter issues are labeled [good first issue](https://github.com/limelit-co/open/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22). ## Running a public demo Set `LIMELIT_DEMO=1` and the same binary becomes a read-only public instance: every button that would change or spend anything refuses with an explanation, the credential surface is hidden entirely, and the scheduler, if one is configured, keeps running so history accumulates. A banner names the exact commit the demo is built from and links to it, so a visitor can check that the demo is the open core and not a fork of it. [deploy/](deploy/README.md) is how demo.limelit.co is built and run. Configure the instance first, then set the flag. An unconfigured demo returns a plain error rather than a wizard nobody can submit. ## Configuration `limelit.yaml` holds what to track. It is meant to be committed and diffed, so it never holds a key. ```yaml property: name: Acme domain: acme.com aliases: [Acme Inc, acme.io] competitors: - { name: Globex, domain: globex.com } - { name: Initech, domain: initech.com } targets: - chatgpt:openai:gpt-5.5:online - claude:anthropic:online - perplexity:perplexity:sonar - ai_overview:dataforseo limits: runs_per_day: 200 schedule: daily # daily, hourly, or off ``` Credentials come from the environment (or the settings store, with the environment winning): ``` OPENAI_API_KEY, ANTHROPIC_API_KEY, PERPLEXITY_API_KEY, GOOGLE_API_KEY, OPENROUTER_API_KEY, DATAFORSEO_LOGIN, DATAFORSEO_PASSWORD, SEARCHAPI_KEY, CLORO_API_KEY, BRIGHTDATA_API_TOKEN, OXYLABS_USERNAME, OXYLABS_PASSWORD, OLOSTEP_API_KEY ``` `LIMELIT_DATA_DIR` sets where the SQLite database lives (default `./data`). `LIMELIT_SECRET` is the key that encrypts credentials pasted into the dashboard; leave it unset and one is generated beside the database. Everything under `limits` and `schedule` can also be changed in Settings while the server runs; a value saved there wins over the file, and the scheduler picks up a change within a minute. Settings also pauses and resumes a target (its answers stay, the runner skips it) and shows when each target last answered and last failed. One pass on demand, or one target on its own: ```bash limelit run --target chatgpt:openai:online ``` ## How the numbers are computed Nothing here is a black box. This is the short version; the full method, with every formula, every exclusion and the test that enforces each one, is [docs/methodology.md](docs/methodology.md). 1. **You define the brands.** Your property (name, aliases, domain) and your competitors (name and domain; the domain is the identity key). 2. **Every active prompt runs against every enabled target**, on demand or on a schedule. Each answer is stored as text with the sources it cited. 3. **Mentions are found by text search.** For the names you gave us, in the text we stored. Rank comes from the enclosing list item when the answer is a ranked list. No model decides what it saw, so nothing can be invented and nothing is missed because a model stayed quiet. 4. **Citations are classified** by host: your own site, a tracked competitor, social, informational, or other. 5. **Metrics are aggregations over those rows**, and only those rows: | Metric | Definition | |---|---| | Visibility | share of answers that mention the brand | | Share of voice | the brand's mentions over all tracked brands' mentions in the same answers | | Position | mean rank where the brand appears in a ranked list | | Citation share | share of cited sources that are the brand's own site | Two denominator rules, because this is where visibility metrics usually go wrong: - **Prompts that name your own brand are tagged `branded`** and left out of the headline number. Asking an engine about yourself and counting the answer is the easiest way to inflate the metric. - **An answer surface that did not render is not a miss.** If a query produced no Google AI Overview at all, that run is excluded from the denominator rather than counted as an answer that ignored you. Every result carries `n`, the number of answers it rests on, so a number from four runs never gets read as a trend. ## Cost There is no pricing, no credits and no markup in this project. You pay your providers directly, at their rates. What the tool gives you instead: - **Usage counters**: calls and tokens per target per day, so you can reconcile against your own provider bill. - **A hard ceiling**: `limits.runs_per_day` (default 200). An evaluation that would exceed it is refused before anything is spent, and tells you by how much. - **No per-answer model call.** Mention detection is a text search, so the only thing you pay for is the answer itself. ## Compared with other AI visibility tools The commercial platforms in this category are good products with real capabilities this project does not have. The axis where an open core wins is control: reading the code behind every number, running it on your own infrastructure, and keeping the data. | | Open source | Self-hostable | Auditable metrics | Data ownership | Keys | Pricing | |---|---|---|---|---|---|---| | **Limelit Open** (this repo) | Yes, Apache-2.0 | Yes | Yes, the scoring code is this repo | Yours, a SQLite file | Bring your own | Free | | [**Limelit Cloud**](https://limelit.co) | Open core, this repo | Yes, by self-hosting this repo | Yes, the same definitions, published here | Vendor-hosted, exportable | Included | Commercial | | [Profound](https://www.tryprofound.com) | No | No | No | Vendor-hosted | Included | Commercial | | [Peec AI](https://peec.ai) | No | No | No | Vendor-hosted | Included | Commercial | | [Otterly.AI](https://otterly.ai) | No | No | No | Vendor-hosted | Included | Commercial | | [Scrunch AI](https://www.scrunchai.com) | No | No | No | Vendor-hosted | Included | Commercial | | [Ahrefs Brand Radar](https://ahrefs.com/brand-radar) | No | No | No | Vendor-hosted | Included | Commercial, bundled with Ahrefs | | [Semrush AI Toolkit](https://www.semrush.com) | No | No | No | Vendor-hosted | Included | Commercial, bundled with Semrush | Limelit is the only one of these with an open-source core: Limelit Cloud is the managed version of this project, and the metric definitions it uses are the ones published here. Choosing it is a hosting decision, not a lock-in one, and `limelit export` moves your data either way. Current prices change often; check each vendor's own pricing page. To be fair about where the commercial tools are ahead today: several offer prompt volume estimates, sentiment analysis, AI crawler analytics, on-page content optimization, and integration with an established SEO dataset. This project does none of those, and some of them are deliberately [hosted only](#hosted-only). ## Hosted only These are [Limelit Cloud](https://limelit.co) features and are not in the open core: - Query fan-out **rewrite analysis** (the capture itself is in the open core: every answer stores the searches the engine ran) - Prompt generation from your site, personas, competitor suggestion - Discovery of brands you did not list - Sentiment and framing, hallucination guard, correction drafts - Perception audits - Google Search Console and GA4 - Agents, sheets and blocks - Portfolios and multi-brand, white-label, digest emails ### Moving to Limelit Cloud ```bash limelit upgrade --key <your Limelit Cloud API key> ``` It uploads your property, competitors, prompts, answers, mentions, citations and fan-out, then prints the Cloud MCP endpoint to point your client at. The Limelit Cloud page in the dashboard runs the same move from a form. - **Nothing is deleted here.** The instance keeps everything, so a failed import is recoverable and leaving again is a command. - **No provider key is ever sent.** The payload is data. The OpenAI or Anthropic key that produced it stays on your machine. - **Re-running is safe.** Cloud keys each answer on your instance's own id, so an upgrade interrupted halfway and re-run imports nothing twice. It reports how many it skipped. - `--since 2026-06-01` narrows a large history. The same move is available to an agent as the `upgrade_to_cloud` tool. Called without a key it explains what Cloud adds and moves nothing. To keep measuring here and see the charts in ChatGPT, turn on **Sync to Limelit Cloud** in Settings instead: every run's answers are copied to your Cloud workspace, and ChatGPT charts them through the Limelit app. See [docs/chatgpt.md](docs/chatgpt.md). ## Glossary - **AI visibility**: whether and how a brand appears in answers generated by AI assistants, as distinct from ranking in a list of blue links. - **AEO, Answer Engine Optimization**: the practice of improving that. - **GEO, Generative Engine Optimization**: the same practice, different name. - **AIO, AI Search Optimization**: likewise. - **LLMO, LLM Optimization**: likewise. - **Answer engine**: a product that answers a question directly rather than returning links. ChatGPT, Perplexity, Google AI Overviews and AI Mode, Claude, Gemini, Copilot. - **Citation**: a source an answer engine attributes or links while answering. - **Share of voice**: your brand's share of all tracked brand mentions across the same set of answers. - **Prompt category**: the shape of the question. Discovery prompts ask for a recommendation without naming anyone, comparison prompts name a rival, use case prompts describe a job, brand prompts name you. Visibility is reported per category as well as overall, because an answer to "Rival alternatives" lists rivals by construction and reads as a loss if you score it the same way as "best tools for X". - **Query fan-out**: the web searches an engine runs to ground an answer before writing it. ## FAQ **Does this replace my SEO tool?** No. It measures a different surface. Traditional SEO tools measure ranked links; this measures what a generated answer says and cites. **Why does my ChatGPT number differ from what I see in ChatGPT?** Because an API call with web search on and the consumer product are different surfaces. Both are tracked, they are labeled `api` and `scraped`, and they are never averaged together. To measure what a person sees, use a scraped target. **Do I need a scraper account?** Not to start. One API key gets you running. Scrapers are what you add when you want the consumer surface or the Google AI surfaces, which have no API. **Does any of my data leave my machine?** Only the prompt text, in the calls to the engines and scrapers you configure. Answers, mentions, citations and usage stay in your SQLite file. **Can I track more than one brand?** Not in v0.1, which is one property per instance. Run several instances, or use the hosted product, which is built for portfolios. **What database does it use?** SQLite, pure Go, no cgo. A Postgres option is on the list, not in v0.1. ## Roadmap v0.1 is the first usable release: the wizard, the runner, the dashboard, the MCP server, the API providers and the first scrapers. Tracked in the [v0.1 milestone](https://github.com/limelit-co/open/milestone/1). After that: scraped ChatGPT and Gemini through LLM-scraper endpoints, multi-property per instance, Postgres as an alternative store. ## Development Go 1.25 or newer. No other toolchain: no Node, no Docker, no Postgres. ```bash make build # bin/limelit make test # go test ./... make lint # gofmt + go vet make run # build, then serve on :1515 ``` The screenshots in [docs/screenshots](docs/screenshots) are taken from demo.limelit.co at a 1440px viewport. When a chart or table changes shape, retake the ones it appears in; a README that shows a screen the binary no longer draws is worse than one with no pictures. Layout: ``` cmd/limelit the binary and its verbs internal/config limelit.yaml plus credentials from the environment internal/store SQLite, embedded migrations, the repository layer internal/engines the tracked answer engines internal/provider the provider interface, typed errors, the registry, and the providers internal/target engine:provider[:model][:online] internal/promptpack the starter prompt templates internal/mentions the deterministic brand matcher and list ranking internal/citations URL normalisation and source classification internal/runner the evaluation runner: the ceiling, usage counters internal/metrics the read models every surface shares: visibility, share of voice, position, the grid, the answers internal/secrets encryption at rest for pasted provider keys internal/ui the embedded dashboard: templates, CSS, handlers internal/export the whole instance as JSON or CSV, streamed internal/upgrade the one-command move to Limelit Cloud internal/mcpserver the MCP tool catalog, on the official go-sdk internal/httpx HTTP surface: dashboard, JSON API, MCP over HTTP deploy/ the container, Litestream, and how the demo is deployed docs/ the tool catalog, the provider contract, the methodology ``` ## Contributing Issues are labeled by area, and the provider adapters are deliberately small and self-contained. Start with [good first issue](https://github.com/limelit-co/open/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22). [CONTRIBUTING.md](CONTRIBUTING.md) has the rules and the walk-through for adding a provider. The three worth knowing before a pull request: - Original code only. Do not copy code in from other projects. - Tests run offline. Every provider ships with recorded fixtures and tests that need no network and no keys. - Sign off your commits with `git commit -s`. That is the [Developer Certificate of Origin](https://developercertificate.org/): you are stating that you wrote the patch, or have the right to submit it under this license. There is no CLA and no copyright assignment; you keep the copyright in what you write. Questions or ideas: join the [Limelit Discord](https://discord.gg/g2Ef3WSTTC). ## License Apache-2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE). Copyright 2026 Limelit. The license is a grant, not a transfer: Limelit holds the copyright in the code it wrote, contributors hold the copyright in theirs, and everyone, including Limelit, uses the whole under Apache-2.0. You may run it, modify it, self-host it, and ship it inside a commercial product, provided you keep the license, the copyright notices, and the NOTICE file, and state what you changed.