Supalytics CLI

Command-line interface for Supalytics web analytics.

░█▀▀░█░█░█▀█░█▀█░█░░░█░█░▀█▀░▀█▀░█▀▀░█▀▀
░▀▀█░█░█░█▀▀░█▀█░█░░░░█░░░█░░░█░░█░░░▀▀█
░▀▀▀░▀▀▀░▀░░░▀░▀░▀▀▀░░▀░░░▀░░▀▀▀░▀▀▀░▀▀▀

Requirements

• Bun runtime

Installation

bun add -g @supalytics/cli

Setup

Quick Start

supalytics init

Opens browser to log in, creates your site, and gives you the tracking snippet.

Manual Setup

supalytics login           # Opens browser for authentication
supalytics sites add       # Create a new site

Usage

Quick Stats

supalytics stats              # Last 30 days (default)
supalytics stats today
supalytics stats yesterday
supalytics stats week
supalytics stats month
supalytics stats 7d

Realtime

supalytics realtime           # Current visitors
supalytics realtime --watch   # Auto-refresh every 30s

Trend

supalytics trend              # Daily visitor trend with bar chart
supalytics trend --period 7d  # Last 7 days
supalytics trend --compact    # Compact sparkline only

Breakdowns

supalytics pages              # Top pages
supalytics referrers          # Top referrers
supalytics countries          # Traffic by country

Custom Queries

# Top pages with revenue
supalytics query -d page -m visitors,revenue

# Traffic by country and device
supalytics query -d country,device -m visitors

# Filter by country
supalytics query -d page -f "country:is:US"

# UTM campaign performance
supalytics query -d utm_source,utm_campaign -m visitors,revenue

Events

supalytics events                          # List all events
supalytics events signup                   # Show properties for event
supalytics events signup --property plan   # Breakdown by property

Options

All commands support:

• -s, --site <domain> - Query a specific site
• -t, --test - Query localhost/test data instead of production
• --json - Output raw JSON
• --no-revenue - Exclude revenue metrics
• -f, --filter <filter> - Filter data (format: field:operator:value)

Filters

-f "country:is:US"
-f "page:contains:/blog"
-f "device:is:mobile"
-f "referrer:is:twitter.com"

Site Management

supalytics sites                       # List all sites
supalytics sites add example.com       # Create site with domain
supalytics sites add my-project        # Or use any name, update later
supalytics sites update my-project -d example.com  # Set the real domain
supalytics default example.com         # Set default site
supalytics stats -s other.com          # Query specific site

Shell Completions

Enable tab completion for your shell:

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

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

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

License

Apache-2.0