llmpulse-cli

The official CLI for LLM Pulse — the AI visibility analytics platform that tracks how your brand appears across ChatGPT, Perplexity, Gemini, Google AI Overviews, and other AI search engines.

Monitor brand mentions, citations, sentiment, and share of voice directly from your terminal. Export data, generate reports, and automate AI visibility tracking in your workflows.

Installation

# npm
npm install -g llmpulse-cli

# pnpm
pnpm add -g llmpulse-cli

# yarn
yarn global add llmpulse-cli

# bun
bun add -g llmpulse-cli

# Run without installing
npx llmpulse-cli status

Quick Start

# Interactive setup — validates your key and sets defaults
llmpulse login

# Quick project dashboard with sparklines
llmpulse status

# Weekly visibility report
llmpulse report --range 7

# Compare this week vs last week
llmpulse diff --range 7 --compare 7

# Live-updating dashboard
llmpulse watch --interval 30

Get your API key from the LLM Pulse dashboard (Scale plan or above).

Commands

Dashboard & Reports

| Command | Description | |---------|-------------| | login | Interactive setup — configure API key and default project | | status | Quick dashboard: metrics, sparklines, SoV, top prompts | | diff | Compare metrics between two time periods | | report | Full visibility report (terminal or --markdown) | | watch | Live auto-refreshing dashboard | | export | Export full project data to JSON + CSV files |

Data Queries

| Command | Description | |---------|-------------| | dimensions projects | List/get projects | | dimensions competitors | List/get competitors | | dimensions collections | List collections/tags | | dimensions tags | Alias for collections/tags | | dimensions models | List AI models (ChatGPT, Perplexity, Gemini, etc.) | | dimensions locales | List tracked countries and languages | | dimensions prompts | List tracked prompts | | dimensions executions | List prompt executions | | dimensions mentions | List brand mentions in AI responses | | dimensions citations | List brand citations (URLs) in AI responses | | dimensions competitor-mentions | List competitor mentions | | dimensions competitor-citations | List competitor citations | | dimensions all-mentions | All mentions (brand + competitors) | | dimensions all-citations | All citations (brand + competitors) | | dimensions agent-bots | List the AI bot/crawler catalog and companies (no project required) | | citations list | Grouped citation intelligence by URL/domain/host | | citations get <url_sha256> | URL-level cited-page intelligence and evidence | | citations occurrences <url_sha256> | Answers where a cited URL appeared | | citations content <url_sha256> | Sanitized cached page content for a cited URL | | metrics timeseries | Time series data (mentions, citations, visibility, etc.) | | metrics summary | Aggregated metrics summary | | metrics prompt-summary | Per-prompt performance breakdown | | metrics sov | Share of voice analysis | | metrics top-sources | Top citing domains | | metrics agent-traffic | Aggregated AI bot/crawler traffic (Scale plan or above) | | metrics ai-model-summary | Aggregate AI Model Insights summary | | metrics ai-model-positions | AI Model Insights position-distribution comparison | | metrics ai-overview-results | Google AI Overview result-availability aggregates | | answers list | List AI model responses | | answers get <id> | Full response with mentions, citations, sentiments, shopping products, brand entities, and optional source page details | | sentiments list | Sentiment analysis records | | recommendations list | List recommendation runs | | recommendations get <id> | Get one recommendation run with items and source refs | | intelligence-tasks list | List content intelligence tasks | | intelligence-tasks get <id> | Get one task with full result data |

Write Operations

These commands mutate data and require a writable API key (and, where noted, a specific plan). The target project is taken from --project-id or your default project.

| Command | Description | |---------|-------------| | prompts create <text>... | Add prompts in bulk (--country-code and --language-code required) | | prompts assign-tags | Attach tags/collections to prompts (--prompt-ids, --tag-ids/--tag-names) | | competitors create | Track a competitor (--brand-name, --domain, optional --matching-names) | | collections create | Create a collection/tag (--name, optional --prompt-ids) | | annotations create | Create a timeline annotation (--title; Growth plan or above) | | intelligence-tasks create | Queue a content intelligence task (--task-type) | | reports technical-geo | Queue a technical GEO report for a URL (--url) |

# Add prompts (each prompt is a positional argument, so commas are preserved)
llmpulse prompts create "best crm for startups" "top crm tools, ranked" \
  --country-code US --language-code en

# Tag prompts, creating any missing tag names
llmpulse prompts assign-tags --prompt-ids 101,102 --tag-names "crm,priority" --create-missing

# Track a competitor
llmpulse competitors create --brand-name "Acme" --domain acme.com --matching-names "Acme Inc,Acme Co"

Configuration

| Command | Description | |---------|-------------| | config set/get/show | Manage configuration | | config use <profile> | Switch between profiles (e.g., production, staging) | | config profiles | List all profiles | | completions bash\|zsh\|fish | Generate shell autocompletions |

Output Formats

All data commands support three output formats via --format / -f:

• JSON (default) — pretty-printed on TTY, compact when piped (works with jq)
• Table — colored, auto-sized columns with sparklines and percent bars
• CSV — standard CSV for spreadsheets and data pipelines

# Pipe to jq
llmpulse metrics summary --metrics mentions,visibility | jq '.summary'

# Export to CSV
llmpulse dimensions citations --all -f csv > citations.csv

# Auto-paginate all results
llmpulse dimensions mentions --all -f csv > all-mentions.csv

# Include the main brand in the competitor list
llmpulse dimensions competitors list --include-project-brand

# Review recommendation runs
llmpulse recommendations list
llmpulse recommendations get 123

Global Flags

| Flag | Short | Description | |------|-------|-------------| | --api-key | -k | Override API key | | --base-url | | Override base URL | | --project-id | -p | Override default project | | --format | -f | Output: json, table, csv | | --page | | Page number | | --per-page | | Items per page (max 100) | | --all | | Auto-paginate all results | | --verbose | -v | Show request URL, timing, request ID |

Configuration

Config is stored in ~/.llmpulse/config.json with optional profile overrides.

Priority: CLI flag > environment variable > config file > default

| Config Key | Environment Variable | Default | |------------|---------------------|---------| | api_key | LLMPULSE_API_KEY | — | | base_url | LLMPULSE_BASE_URL | https://api.llmpulse.ai/api/v1 | | default_project_id | LLMPULSE_PROJECT_ID | — |

Profiles

Switch between multiple accounts or environments:

llmpulse config use production
llmpulse config set api_key llmpulse_prod_xxx

llmpulse config use staging
llmpulse config set api_key llmpulse_staging_xxx

llmpulse config profiles     # List all profiles
llmpulse config use production  # Switch back

Shell Completions

# Bash — add to ~/.bashrc
eval "$(llmpulse completions bash)"

# Zsh — add to ~/.zshrc
eval "$(llmpulse completions zsh)"

# Fish
llmpulse completions fish > ~/.config/fish/completions/llmpulse.fish

What is LLM Pulse?

LLM Pulse is an AI visibility analytics platform that monitors how brands appear in AI-generated search results. It tracks brand mentions, citations, and sentiment across leading AI models including ChatGPT, Perplexity, Gemini, Google AI Overviews, and Google AI Mode.

Key features include:

• Brand Mention Tracking — monitor when AI models mention your brand
• Citation Analysis — track which URLs AI models cite from your domain
• Share of Voice — measure your visibility vs competitors in AI responses
• Sentiment Analysis — understand how AI describes your brand
• Competitive Benchmarking — compare your AI presence against competitors
• API & MCP Server — integrate AI visibility data into your workflows
• Looker Studio Connector — visualize data in custom dashboards

Related

• LLM Pulse — AI visibility analytics platform
• API Documentation — REST API reference
• MCP Server — Model Context Protocol integration for AI assistants
• Looker Studio Connector — Google Looker Studio integration

Requirements

• Node.js >= 18
• LLM Pulse API key (Scale plan or above)

License

MIT