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 models | List AI models (ChatGPT, Perplexity, Gemini, etc.) | | dimensions locales | List tracked countries and languages | | dimensions prompts | List tracked prompts | | 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) | | 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 | | answers list | List AI model responses | | answers get <id> | Full response with mentions, citations, sentiments | | sentiments list | Sentiment analysis records |

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

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