@supalytics/cli 0.1.2 → 0.3.0

package/README.md

@@ -20,10 +20,19 @@ bun add -g @supalytics/cli
 
 ## Setup
 
-Get your API key from the Settings page at [www.supalytics.co](https://www.supalytics.co), then:
+### Quick Start
 
 ```bash
-supalytics login <your-api-key>
+supalytics init
+```
+
+Opens browser to log in, creates your site, and gives you the tracking snippet.
+
+### Manual Setup
+
+```bash
+supalytics login           # Opens browser for authentication
+supalytics sites add       # Create a new site
 ```
 
 ## Usage
@@ -46,6 +55,14 @@ supalytics realtime           # Current visitors
 supalytics realtime --watch   # Auto-refresh every 30s
 ```
 
+### Trend
+
+```bash
+supalytics trend              # Daily visitor trend with bar chart
+supalytics trend --period 7d  # Last 7 days
+supalytics trend --compact    # Compact sparkline only
+```
+
 ### Breakdowns
 
 ```bash
@@ -83,6 +100,7 @@ supalytics events signup --property plan   # Breakdown by property
 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`)
@@ -96,15 +114,31 @@ All commands support:
 -f "referrer:is:twitter.com"
 ```
 
-## Multi-site Support
+## Site Management
 
 ```bash
-supalytics login <api-key>        # Add a site
 supalytics sites                  # List all sites
+supalytics sites add              # Create a new site
+supalytics sites update           # Update site settings
 supalytics default <domain>       # Set default site
 supalytics stats -s other.com     # Query specific site
 ```
 
+## Shell Completions
+
+Enable tab completion for your shell:
+
+```bash
+# 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supalytics/cli",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "description": "CLI for Supalytics web analytics",
   "type": "module",
   "bin": {
@@ -33,6 +33,7 @@
   },
   "dependencies": {
     "chalk": "^5.6.2",
-    "commander": "^14.0.2"
+    "commander": "^14.0.2",
+    "open": "^10.1.0"
   }
 }

package/src/api.ts

@@ -12,6 +12,7 @@ export interface QueryRequest {
   limit?: number;
   offset?: number;
   include_revenue?: boolean;
+  is_dev?: boolean; // Test mode: query localhost data instead of production
 }
 
 export interface QueryResult {
@@ -159,7 +160,8 @@ export interface PropertyBreakdownResponse {
 export async function listEvents(
   site: string,
   period: string = "30d",
-  limit: number = 100
+  limit: number = 100,
+  isDev: boolean = false
 ): Promise<EventsResponse> {
   const apiKey = await getApiKeyForSite(site);
 
@@ -176,6 +178,9 @@ export async function listEvents(
   }
 
   const params = new URLSearchParams({ period, limit: String(limit) });
+  if (isDev) {
+    params.set("is_dev", "true");
+  }
   const response = await fetch(`${API_BASE}/v1/events?${params}`, {
     headers: { Authorization: `Bearer ${apiKey}` },
   });
@@ -194,7 +199,8 @@ export async function listEvents(
 export async function getEventProperties(
   site: string,
   eventName: string,
-  period: string = "30d"
+  period: string = "30d",
+  isDev: boolean = false
 ): Promise<PropertyKeysResponse> {
   const apiKey = await getApiKeyForSite(site);
 
@@ -203,6 +209,9 @@ export async function getEventProperties(
   }
 
   const params = new URLSearchParams({ period });
+  if (isDev) {
+    params.set("is_dev", "true");
+  }
   const response = await fetch(
     `${API_BASE}/v1/events/${encodeURIComponent(eventName)}/properties?${params}`,
     { headers: { Authorization: `Bearer ${apiKey}` } }
@@ -225,7 +234,8 @@ export async function getPropertyBreakdown(
   propertyKey: string,
   period: string = "30d",
   limit: number = 100,
-  includeRevenue: boolean = false
+  includeRevenue: boolean = false,
+  isDev: boolean = false
 ): Promise<PropertyBreakdownResponse> {
   const apiKey = await getApiKeyForSite(site);
 
@@ -238,6 +248,9 @@ export async function getPropertyBreakdown(
     limit: String(limit),
     include_revenue: String(includeRevenue),
   });
+  if (isDev) {
+    params.set("is_dev", "true");
+  }
   const response = await fetch(
     `${API_BASE}/v1/events/${encodeURIComponent(eventName)}/properties/${encodeURIComponent(propertyKey)}?${params}`,
     { headers: { Authorization: `Bearer ${apiKey}` } }
@@ -283,7 +296,7 @@ export interface RealtimeResponse {
 /**
  * Get realtime visitors
  */
-export async function getRealtime(site: string): Promise<RealtimeResponse> {
+export async function getRealtime(site: string, isDev: boolean = false): Promise<RealtimeResponse> {
   const apiKey = await getApiKeyForSite(site);
 
   if (!apiKey) {
@@ -298,7 +311,12 @@ export async function getRealtime(site: string): Promise<RealtimeResponse> {
     );
   }
 
-  const response = await fetch(`${API_BASE}/v1/realtime`, {
+  const params = new URLSearchParams();
+  if (isDev) {
+    params.set("is_dev", "true");
+  }
+  const url = params.toString() ? `${API_BASE}/v1/realtime?${params}` : `${API_BASE}/v1/realtime`;
+  const response = await fetch(url, {
     headers: { Authorization: `Bearer ${apiKey}` },
   });
 

package/src/commands/completions.ts

@@ -0,0 +1,328 @@
+import { Command } from "commander";
+
+const BASH_COMPLETION = `# Supalytics CLI Bash Completion
+# Add this to ~/.bashrc or ~/.bash_profile:
+#   eval "$(supalytics completions bash)"
+
+_supalytics_completions() {
+    local cur prev commands opts
+    COMPREPLY=()
+    cur="\${COMP_WORDS[COMP_CWORD]}"
+    prev="\${COMP_WORDS[COMP_CWORD-1]}"
+
+    commands="init login logout sites default remove stats pages referrers countries trend query events realtime completions help"
+
+    # Main command completion
+    if [[ \${COMP_CWORD} -eq 1 ]]; then
+        COMPREPLY=( $(compgen -W "\${commands}" -- \${cur}) )
+        return 0
+    fi
+
+    # Subcommand options
+    case "\${COMP_WORDS[1]}" in
+        stats)
+            opts="today yesterday week month year 7d 14d 30d 90d 12mo all --site --start --end --filter --all --no-revenue --json"
+            ;;
+        pages|referrers|countries)
+            opts="--site --period --start --end --limit --filter --no-revenue --json"
+            ;;
+        trend)
+            opts="--site --period --start --end --filter --no-revenue --compact --json"
+            ;;
+        query)
+            opts="--site --metrics --dimensions --filter --sort --timezone --period --start --end --limit --offset --no-revenue --json"
+            ;;
+        events)
+            opts="--site --period --property --limit --no-revenue --json"
+            ;;
+        realtime)
+            opts="--site --json --watch"
+            ;;
+        init)
+            opts=""
+            ;;
+        login)
+            opts=""
+            ;;
+        logout)
+            opts=""
+            ;;
+        sites)
+            opts="add update"
+            ;;
+        completions)
+            opts="bash zsh fish"
+            ;;
+        *)
+            opts=""
+            ;;
+    esac
+
+    COMPREPLY=( $(compgen -W "\${opts}" -- \${cur}) )
+    return 0
+}
+
+complete -F _supalytics_completions supalytics
+`;
+
+const ZSH_COMPLETION = `#compdef supalytics
+# Supalytics CLI Zsh Completion
+# Add this to ~/.zshrc:
+#   eval "$(supalytics completions zsh)"
+
+_supalytics() {
+    local -a commands
+    commands=(
+        'init:Quick setup - login, create site, get snippet'
+        'login:Authenticate with Supalytics'
+        'logout:Log out (keeps site API keys)'
+        'sites:List and manage configured sites'
+        'default:Set the default site'
+        'remove:Remove a site'
+        'stats:Overview stats (pageviews, visitors, bounce rate, revenue)'
+        'pages:Top pages by visitors'
+        'referrers:Top referrers'
+        'countries:Traffic by country'
+        'trend:Daily visitor trend'
+        'query:Flexible query with custom metrics and dimensions'
+        'events:List and explore custom events'
+        'realtime:Live visitors on your site right now'
+        'completions:Generate shell completions'
+        'help:Display help for command'
+    )
+
+    local -a period_opts
+    period_opts=(
+        'today:Today only'
+        'yesterday:Yesterday only'
+        'week:This week'
+        'month:This month'
+        'year:This year'
+        '7d:Last 7 days'
+        '14d:Last 14 days'
+        '30d:Last 30 days'
+        '90d:Last 90 days'
+        '12mo:Last 12 months'
+        'all:All time'
+    )
+
+    _arguments -C \\
+        '1: :->command' \\
+        '*:: :->args'
+
+    case \$state in
+        command)
+            _describe 'command' commands
+            ;;
+        args)
+            case \$words[1] in
+                stats)
+                    _arguments \\
+                        '1: :->period' \\
+                        '--site[Site to query]:domain:' \\
+                        '--start[Start date]:date:' \\
+                        '--end[End date]:date:' \\
+                        '*--filter[Filter]:filter:' \\
+                        '--all[Show detailed breakdown]' \\
+                        '--no-revenue[Exclude revenue metrics]' \\
+                        '--json[Output as JSON]'
+                    case \$state in
+                        period)
+                            _describe 'period' period_opts
+                            ;;
+                    esac
+                    ;;
+                pages|referrers|countries)
+                    _arguments \\
+                        '--site[Site to query]:domain:' \\
+                        '--period[Time period]:period:(7d 14d 30d 90d 12mo all)' \\
+                        '--start[Start date]:date:' \\
+                        '--end[End date]:date:' \\
+                        '--limit[Number of results]:limit:' \\
+                        '*--filter[Filter]:filter:' \\
+                        '--no-revenue[Exclude revenue metrics]' \\
+                        '--json[Output as JSON]'
+                    ;;
+                trend)
+                    _arguments \\
+                        '--site[Site to query]:domain:' \\
+                        '--period[Time period]:period:(7d 14d 30d 90d 12mo all)' \\
+                        '--start[Start date]:date:' \\
+                        '--end[End date]:date:' \\
+                        '*--filter[Filter]:filter:' \\
+                        '--no-revenue[Exclude revenue metrics]' \\
+                        '--compact[Show compact sparkline only]' \\
+                        '--json[Output as JSON]'
+                    ;;
+                query)
+                    _arguments \\
+                        '--site[Site to query]:domain:' \\
+                        '--metrics[Metrics]:metrics:(visitors bounce_rate avg_session_duration revenue conversions)' \\
+                        '--dimensions[Dimensions]:dimensions:(page referrer country region city browser os device date hour event)' \\
+                        '*--filter[Filter]:filter:' \\
+                        '--sort[Sort by field]:sort:' \\
+                        '--timezone[Timezone]:timezone:' \\
+                        '--period[Time period]:period:(7d 14d 30d 90d 12mo all)' \\
+                        '--start[Start date]:date:' \\
+                        '--end[End date]:date:' \\
+                        '--limit[Number of results]:limit:' \\
+                        '--offset[Skip results]:offset:' \\
+                        '--no-revenue[Exclude revenue metrics]' \\
+                        '--json[Output as JSON]'
+                    ;;
+                events)
+                    _arguments \\
+                        '1:event name:' \\
+                        '--site[Site to query]:domain:' \\
+                        '--period[Time period]:period:(7d 14d 30d 90d 12mo all)' \\
+                        '--property[Property key]:property:' \\
+                        '--limit[Number of results]:limit:' \\
+                        '--no-revenue[Exclude revenue]' \\
+                        '--json[Output as JSON]'
+                    ;;
+                realtime)
+                    _arguments \\
+                        '--site[Site to query]:domain:' \\
+                        '--json[Output as JSON]' \\
+                        '--watch[Auto-refresh every 30 seconds]'
+                    ;;
+                init)
+                    _arguments '1:identifier:'
+                    ;;
+                login)
+                    ;;
+                logout)
+                    ;;
+                sites)
+                    local -a sites_commands
+                    sites_commands=(
+                        'add:Create a new site'
+                        'update:Update a site domain'
+                    )
+                    _describe 'sites command' sites_commands
+                    ;;
+                default|remove)
+                    _arguments '1:domain:'
+                    ;;
+                completions)
+                    _arguments '1:shell:(bash zsh fish)'
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_supalytics
+`;
+
+const FISH_COMPLETION = `# Supalytics CLI Fish Completion
+# Add this to ~/.config/fish/completions/supalytics.fish:
+#   supalytics completions fish > ~/.config/fish/completions/supalytics.fish
+
+# Disable file completion by default
+complete -c supalytics -f
+
+# Commands
+complete -c supalytics -n "__fish_use_subcommand" -a "init" -d "Quick setup - login, create site, get snippet"
+complete -c supalytics -n "__fish_use_subcommand" -a "login" -d "Authenticate with Supalytics"
+complete -c supalytics -n "__fish_use_subcommand" -a "logout" -d "Log out (keeps site API keys)"
+complete -c supalytics -n "__fish_use_subcommand" -a "sites" -d "List and manage configured sites"
+complete -c supalytics -n "__fish_use_subcommand" -a "default" -d "Set the default site"
+complete -c supalytics -n "__fish_use_subcommand" -a "remove" -d "Remove a site"
+complete -c supalytics -n "__fish_use_subcommand" -a "stats" -d "Overview stats"
+complete -c supalytics -n "__fish_use_subcommand" -a "pages" -d "Top pages by visitors"
+complete -c supalytics -n "__fish_use_subcommand" -a "referrers" -d "Top referrers"
+complete -c supalytics -n "__fish_use_subcommand" -a "countries" -d "Traffic by country"
+complete -c supalytics -n "__fish_use_subcommand" -a "trend" -d "Daily visitor trend"
+complete -c supalytics -n "__fish_use_subcommand" -a "query" -d "Flexible query with custom metrics"
+complete -c supalytics -n "__fish_use_subcommand" -a "events" -d "List and explore custom events"
+complete -c supalytics -n "__fish_use_subcommand" -a "realtime" -d "Live visitors right now"
+complete -c supalytics -n "__fish_use_subcommand" -a "completions" -d "Generate shell completions"
+complete -c supalytics -n "__fish_use_subcommand" -a "help" -d "Display help for command"
+
+# Stats options
+complete -c supalytics -n "__fish_seen_subcommand_from stats" -a "today yesterday week month year 7d 14d 30d 90d 12mo all"
+complete -c supalytics -n "__fish_seen_subcommand_from stats" -l site -s s -d "Site to query"
+complete -c supalytics -n "__fish_seen_subcommand_from stats" -l start -d "Start date"
+complete -c supalytics -n "__fish_seen_subcommand_from stats" -l end -d "End date"
+complete -c supalytics -n "__fish_seen_subcommand_from stats" -l filter -s f -d "Filter"
+complete -c supalytics -n "__fish_seen_subcommand_from stats" -l all -s a -d "Show detailed breakdown"
+complete -c supalytics -n "__fish_seen_subcommand_from stats" -l no-revenue -d "Exclude revenue"
+complete -c supalytics -n "__fish_seen_subcommand_from stats" -l json -d "Output as JSON"
+
+# Pages/Referrers/Countries options
+complete -c supalytics -n "__fish_seen_subcommand_from pages referrers countries" -l site -s s -d "Site to query"
+complete -c supalytics -n "__fish_seen_subcommand_from pages referrers countries" -l period -s p -d "Time period" -a "7d 14d 30d 90d 12mo all"
+complete -c supalytics -n "__fish_seen_subcommand_from pages referrers countries" -l start -d "Start date"
+complete -c supalytics -n "__fish_seen_subcommand_from pages referrers countries" -l end -d "End date"
+complete -c supalytics -n "__fish_seen_subcommand_from pages referrers countries" -l limit -s l -d "Number of results"
+complete -c supalytics -n "__fish_seen_subcommand_from pages referrers countries" -l filter -s f -d "Filter"
+complete -c supalytics -n "__fish_seen_subcommand_from pages referrers countries" -l no-revenue -d "Exclude revenue"
+complete -c supalytics -n "__fish_seen_subcommand_from pages referrers countries" -l json -d "Output as JSON"
+
+# Trend options
+complete -c supalytics -n "__fish_seen_subcommand_from trend" -l site -s s -d "Site to query"
+complete -c supalytics -n "__fish_seen_subcommand_from trend" -l period -s p -d "Time period" -a "7d 14d 30d 90d 12mo all"
+complete -c supalytics -n "__fish_seen_subcommand_from trend" -l start -d "Start date"
+complete -c supalytics -n "__fish_seen_subcommand_from trend" -l end -d "End date"
+complete -c supalytics -n "__fish_seen_subcommand_from trend" -l filter -s f -d "Filter"
+complete -c supalytics -n "__fish_seen_subcommand_from trend" -l no-revenue -d "Exclude revenue"
+complete -c supalytics -n "__fish_seen_subcommand_from trend" -l compact -d "Show compact sparkline"
+complete -c supalytics -n "__fish_seen_subcommand_from trend" -l json -d "Output as JSON"
+
+# Query options
+complete -c supalytics -n "__fish_seen_subcommand_from query" -l site -s s -d "Site to query"
+complete -c supalytics -n "__fish_seen_subcommand_from query" -l metrics -s m -d "Metrics" -a "visitors bounce_rate avg_session_duration revenue conversions"
+complete -c supalytics -n "__fish_seen_subcommand_from query" -l dimensions -s d -d "Dimensions" -a "page referrer country region city browser os device date hour event"
+complete -c supalytics -n "__fish_seen_subcommand_from query" -l filter -s f -d "Filter"
+complete -c supalytics -n "__fish_seen_subcommand_from query" -l sort -d "Sort by field"
+complete -c supalytics -n "__fish_seen_subcommand_from query" -l timezone -d "Timezone"
+complete -c supalytics -n "__fish_seen_subcommand_from query" -l period -s p -d "Time period" -a "7d 14d 30d 90d 12mo all"
+complete -c supalytics -n "__fish_seen_subcommand_from query" -l start -d "Start date"
+complete -c supalytics -n "__fish_seen_subcommand_from query" -l end -d "End date"
+complete -c supalytics -n "__fish_seen_subcommand_from query" -l limit -s l -d "Number of results"
+complete -c supalytics -n "__fish_seen_subcommand_from query" -l offset -d "Skip results"
+complete -c supalytics -n "__fish_seen_subcommand_from query" -l no-revenue -d "Exclude revenue"
+complete -c supalytics -n "__fish_seen_subcommand_from query" -l json -d "Output as JSON"
+
+# Events options
+complete -c supalytics -n "__fish_seen_subcommand_from events" -l site -s s -d "Site to query"
+complete -c supalytics -n "__fish_seen_subcommand_from events" -l period -s p -d "Time period" -a "7d 14d 30d 90d 12mo all"
+complete -c supalytics -n "__fish_seen_subcommand_from events" -l property -d "Property key"
+complete -c supalytics -n "__fish_seen_subcommand_from events" -l limit -s l -d "Number of results"
+complete -c supalytics -n "__fish_seen_subcommand_from events" -l no-revenue -d "Exclude revenue"
+complete -c supalytics -n "__fish_seen_subcommand_from events" -l json -d "Output as JSON"
+
+# Realtime options
+complete -c supalytics -n "__fish_seen_subcommand_from realtime" -l site -s s -d "Site to query"
+complete -c supalytics -n "__fish_seen_subcommand_from realtime" -l json -d "Output as JSON"
+complete -c supalytics -n "__fish_seen_subcommand_from realtime" -l watch -s w -d "Auto-refresh"
+
+# Sites subcommands
+complete -c supalytics -n "__fish_seen_subcommand_from sites; and not __fish_seen_subcommand_from add update" -a "add" -d "Create a new site"
+complete -c supalytics -n "__fish_seen_subcommand_from sites; and not __fish_seen_subcommand_from add update" -a "update" -d "Update a site domain"
+complete -c supalytics -n "__fish_seen_subcommand_from sites; and __fish_seen_subcommand_from update" -l domain -s d -d "New domain name"
+
+# Completions command
+complete -c supalytics -n "__fish_seen_subcommand_from completions" -a "bash zsh fish"
+`;
+
+export const completionsCommand = new Command("completions")
+  .description("Generate shell completions")
+  .argument("<shell>", "Shell type: bash, zsh, or fish")
+  .action((shell: string) => {
+    switch (shell.toLowerCase()) {
+      case "bash":
+        console.log(BASH_COMPLETION);
+        break;
+      case "zsh":
+        console.log(ZSH_COMPLETION);
+        break;
+      case "fish":
+        console.log(FISH_COMPLETION);
+        break;
+      default:
+        console.error(`Unknown shell: ${shell}. Use bash, zsh, or fish.`);
+        process.exit(1);
+    }
+  });

package/src/commands/countries.ts

@@ -14,6 +14,7 @@ export const countriesCommand = new Command("countries")
   .option("-f, --filter <filters...>", "Filters in format 'field:operator:value'")
   .option("--no-revenue", "Exclude revenue metrics")
   .option("--json", "Output as JSON")
+  .option("-t, --test", "Test mode: query localhost data instead of production")
   .action(async (options) => {
     const site = options.site || (await getDefaultSite());
 
@@ -51,6 +52,7 @@ export const countriesCommand = new Command("countries")
         date_range: dateRange,
         limit: parseInt(options.limit),
         include_revenue: options.revenue !== false,
+        is_dev: options.test || false,
       });
 
       if (options.json) {

package/src/commands/events.ts

@@ -9,14 +9,14 @@ Examples:
   # List all events
   supalytics events
 
-  # List properties for an event
+  # Show event stats and properties
   supalytics events signup
 
   # Get breakdown of a property
   supalytics events signup --property plan
 
-  # With revenue
-  supalytics events signup --property plan --revenue`;
+  # Without revenue
+  supalytics events signup --property plan --no-revenue`;
 
 function displayPropertyKeys(response: PropertyKeysResponse, event: string, json: boolean) {
   if (json) {
@@ -48,8 +48,9 @@ export const eventsCommand = new Command("events")
   .option("-p, --period <period>", "Time period: 7d, 14d, 30d, 90d, 12mo, all", "30d")
   .option("--property <key>", "Get breakdown for a specific property")
   .option("-l, --limit <number>", "Number of results", "20")
-  .option("--revenue", "Include revenue in property breakdown")
+  .option("--no-revenue", "Exclude revenue metrics")
   .option("--json", "Output as JSON")
+  .option("-t, --test", "Test mode: query localhost data instead of production")
   .action(async (event, options) => {
     const site = options.site || (await getDefaultSite());
 
@@ -61,7 +62,7 @@ export const eventsCommand = new Command("events")
     try {
       // If no event specified, list all events
       if (!event) {
-        const response = await listEvents(site, options.period, parseInt(options.limit));
+        const response = await listEvents(site, options.period, parseInt(options.limit), options.test || false);
 
         if (options.json) {
           console.log(JSON.stringify(response, null, 2));
@@ -94,7 +95,8 @@ export const eventsCommand = new Command("events")
           options.property,
           options.period,
           parseInt(options.limit),
-          options.revenue
+          options.revenue !== false,
+          options.test || false
         );
 
         if (options.json) {
@@ -113,7 +115,7 @@ export const eventsCommand = new Command("events")
 
         for (const v of response.data) {
           let line = `  ${chalk.cyan(v.value)}  ${formatNumber(v.visitors)} visitors  ${formatNumber(v.count)} events`;
-          if (options.revenue && v.revenue !== null) {
+          if (options.revenue !== false && v.revenue !== null) {
             line += `  ${chalk.green("$" + (v.revenue / 100).toFixed(2))}`;
           }
           console.log(line);
@@ -122,9 +124,47 @@ export const eventsCommand = new Command("events")
         return;
       }
 
-      // If just event name, show properties
-      const response = await getEventProperties(site, event, options.period);
-      displayPropertyKeys(response, event, options.json);
+      // If just event name, show event stats + properties
+      const [eventsResponse, propsResponse] = await Promise.all([
+        listEvents(site, options.period, 100, options.test || false), // Get all events to find this one
+        getEventProperties(site, event, options.period, options.test || false),
+      ]);
+
+      // Find the specific event stats
+      const eventData = eventsResponse.data.find((e) => e.name === event);
+
+      if (options.json) {
+        console.log(JSON.stringify({
+          event: eventData || { name: event, count: 0, visitors: 0, has_properties: false },
+          properties: propsResponse.data,
+          meta: propsResponse.meta,
+        }, null, 2));
+        return;
+      }
+
+      const [startDate, endDate] = propsResponse.meta.date_range;
+      console.log();
+      console.log(chalk.bold(event), chalk.dim(`${startDate} → ${endDate}`));
+      console.log();
+
+      // Show event stats
+      if (eventData) {
+        console.log(`  ${formatNumber(eventData.visitors)} visitors  ${formatNumber(eventData.count)} events`);
+      } else {
+        console.log(chalk.dim("  No data for this event"));
+      }
+      console.log();
+
+      // Show properties
+      if (propsResponse.data.length > 0) {
+        console.log(chalk.dim("  PROPERTIES"));
+        for (const key of propsResponse.data) {
+          console.log(`  ${chalk.cyan(key)}`);
+        }
+        console.log();
+        console.log(chalk.dim(`  Use: supalytics events ${event} --property <key>`));
+      }
+      console.log();
 
     } catch (error) {
       console.error(chalk.red(`Error: ${(error as Error).message}`));