feat: add privacy-first PostHog analytics

- Add PostHog Go SDK for anonymous usage tracking
- Create analytics package with privacy controls
- Support multiple opt-out mechanisms:
  - Config file: disable_analytics setting
  - Environment variables: VAPI_DISABLE_ANALYTICS, VAPI_NO_TELEMETRY, DISABLE_TELEMETRY, DO_NOT_TRACK
- Track command usage patterns, performance, and error types (anonymized)
- No PII collection - only hashed error patterns and anonymous metadata
- Add config analytics subcommands for user control
- Integrate tracking into root command and assistant commands
- Document privacy approach in README with clear opt-out instructions
- Anonymous stable ID generation based on system characteristics
- Graceful failure - analytics never breaks CLI functionality

Author: goosewin

README.md

@@ -203,8 +203,52 @@ vapi config set <key> <value>
 
 # List all configuration options
 vapi config list
+
+# Manage analytics preferences
+vapi config analytics status   # Show current analytics status
+vapi config analytics disable  # Disable analytics collection
+vapi config analytics enable   # Enable analytics collection
 ```
 
+#### Analytics and Privacy
+
+The Vapi CLI collects anonymous usage analytics to help improve the product. **We prioritize your privacy**:
+
+**What we collect:**
+
+- Command usage patterns (anonymous)
+- Error types and frequencies (hashed)
+- Performance metrics
+- Operating system and architecture
+- CLI version information
+
+**What we DON'T collect:**
+
+- API keys or sensitive credentials
+- File contents or personal data
+- User-identifiable information
+- Specific error messages (only hashed patterns)
+
+**How to opt out:**
+
+You can disable analytics collection in multiple ways:
+
+```bash
+# Via CLI command
+vapi config analytics disable
+
+# Via environment variable (any of these)
+export VAPI_DISABLE_ANALYTICS=1
+export VAPI_NO_TELEMETRY=1
+export DISABLE_TELEMETRY=1
+export DO_NOT_TRACK=1
+
+# Via config file
+echo "disable_analytics: true" >> ~/.vapi-cli.yaml
+```
+
+All data is collected anonymously and securely transmitted to PostHog for analysis.
+
 ### Chat Management
 
 Manage text-based chat conversations with Vapi assistants:

cmd/assistant.go

@@ -27,6 +27,7 @@ import (
 	vapi "github.com/VapiAI/server-sdk-go"
 	"github.com/spf13/cobra"
 
+	"github.com/VapiAI/cli/pkg/analytics"
 	"github.com/VapiAI/cli/pkg/output"
 )
 
@@ -47,7 +48,7 @@ var listAssistantCmd = &cobra.Command{
 	Use:   "list",
 	Short: "List all assistants",
 	Long:  `Display all assistants in your account with their IDs, names, and metadata.`,
-	RunE: func(cmd *cobra.Command, args []string) error {
+	RunE: analytics.TrackCommandWrapper("assistant", "list", func(cmd *cobra.Command, args []string) error {
 		fmt.Println("📋 Listing assistants...")
 
 		ctx := context.Background()
@@ -73,6 +74,9 @@ var listAssistantCmd = &cobra.Command{
 
 		if len(assistants) == 0 {
 			fmt.Println("No assistants found. Create one with 'vapi assistant create'")
+			analytics.TrackEvent("assistant_list_empty", map[string]interface{}{
+				"count": 0,
+			})
 			return nil
 		}
 
@@ -92,8 +96,12 @@ var listAssistantCmd = &cobra.Command{
 			fmt.Printf("%-36s %-30s %-20s\n", assistant.Id, name, created)
 		}
 
+		analytics.TrackEvent("assistant_list_success", map[string]interface{}{
+			"count": len(assistants),
+		})
+
 		return nil
-	},
+	}),
 }
 
 var createAssistantCmd = &cobra.Command{
@@ -103,7 +111,7 @@ var createAssistantCmd = &cobra.Command{
 	
 For advanced configuration (voice selection, model parameters, tools), 
 use the Vapi dashboard at https://dashboard.vapi.ai`,
-	RunE: func(cmd *cobra.Command, args []string) error {
+	RunE: analytics.TrackCommandWrapper("assistant", "create", func(cmd *cobra.Command, args []string) error {
 		fmt.Println("🤖 Create a new Vapi assistant")
 		fmt.Println()
 
@@ -146,6 +154,7 @@ use the Vapi dashboard at https://dashboard.vapi.ai`,
 
 		if err := survey.AskOne(confirmPrompt, &confirmCreate); err != nil || !confirmCreate {
 			fmt.Println("Creation canceled.")
+			analytics.TrackEvent("assistant_create_canceled", nil)
 			return nil
 		}
 
@@ -157,15 +166,15 @@ use the Vapi dashboard at https://dashboard.vapi.ai`,
 		fmt.Println("\nVisit https://dashboard.vapi.ai to create and configure assistants.")
 
 		return nil
-	},
+	}),
 }
 
 var getAssistantCmd = &cobra.Command{
 	Use:   "get [assistant-id]",
 	Short: "Get details of a specific assistant",
 	Long:  `Retrieve the full configuration of an assistant including voice, model, and tool settings.`,
 	Args:  cobra.ExactArgs(1),
-	RunE: func(cmd *cobra.Command, args []string) error {
+	RunE: analytics.TrackCommandWrapper("assistant", "get", func(cmd *cobra.Command, args []string) error {
 		ctx := context.Background()
 		assistantID := args[0]
 
@@ -183,7 +192,7 @@ var getAssistantCmd = &cobra.Command{
 		}
 
 		return nil
-	},
+	}),
 }
 
 var updateAssistantCmd = &cobra.Command{
@@ -194,7 +203,7 @@ var updateAssistantCmd = &cobra.Command{
 Complex updates involving voice models, tools, or advanced settings 
 are best done through the Vapi dashboard at https://dashboard.vapi.ai`,
 	Args: cobra.ExactArgs(1),
-	RunE: func(cmd *cobra.Command, args []string) error {
+	RunE: analytics.TrackCommandWrapper("assistant", "update", func(cmd *cobra.Command, args []string) error {
 		assistantID := args[0]
 
 		fmt.Printf("📝 Update assistant: %s\n", assistantID)
@@ -208,7 +217,7 @@ are best done through the Vapi dashboard at https://dashboard.vapi.ai`,
 		fmt.Println("Visit: https://dashboard.vapi.ai/assistants")
 
 		return nil
-	},
+	}),
 }
 
 // nolint:dupl // Delete commands follow a similar pattern across resources
@@ -217,7 +226,7 @@ var deleteAssistantCmd = &cobra.Command{
 	Short: "Delete an assistant",
 	Long:  `Permanently delete an assistant. This cannot be undone.`,
 	Args:  cobra.ExactArgs(1),
-	RunE: func(cmd *cobra.Command, args []string) error {
+	RunE: analytics.TrackCommandWrapper("assistant", "delete", func(cmd *cobra.Command, args []string) error {
 		ctx := context.Background()
 		assistantID := args[0]
 
@@ -234,6 +243,7 @@ var deleteAssistantCmd = &cobra.Command{
 
 		if !confirmDelete {
 			fmt.Println("Deletion canceled.")
+			analytics.TrackEvent("assistant_delete_canceled", nil)
 			return nil
 		}
 
@@ -247,7 +257,7 @@ var deleteAssistantCmd = &cobra.Command{
 
 		fmt.Println("✅ Assistant deleted successfully")
 		return nil
-	},
+	}),
 }
 
 func init() {

cmd/config.go

@@ -26,6 +26,7 @@ import (
 	"github.com/spf13/cobra"
 	"github.com/spf13/viper"
 
+	"github.com/VapiAI/cli/pkg/analytics"
 	"github.com/VapiAI/cli/pkg/config"
 )
 
@@ -229,6 +230,129 @@ func init() {
 	configCmd.AddCommand(configSetCmd)
 	configCmd.AddCommand(configEnvCmd)
 
+	// Add analytics subcommand
+	var analyticsCmd = &cobra.Command{
+		Use:   "analytics",
+		Short: "Manage analytics preferences",
+		Long:  `Configure whether the CLI sends anonymous usage analytics to help improve the product.`,
+	}
+
+	var analyticsStatusCmd = &cobra.Command{
+		Use:   "status",
+		Short: "Show current analytics status",
+		RunE: analytics.TrackCommandWrapper("config", "analytics-status", func(cmd *cobra.Command, args []string) error {
+			cfg := config.GetConfig()
+
+			fmt.Println("📊 Analytics Status")
+			fmt.Println()
+
+			if analytics.IsEnabled() {
+				fmt.Println("✅ Analytics: ENABLED")
+				fmt.Println("   Anonymous usage data is being collected to help improve the CLI")
+			} else {
+				fmt.Println("🚫 Analytics: DISABLED")
+				fmt.Println("   No usage data is being collected")
+			}
+
+			fmt.Println()
+			fmt.Println("Configuration:")
+
+			if cfg != nil && cfg.DisableAnalytics {
+				fmt.Println("  • Config file: disabled")
+			} else {
+				fmt.Println("  • Config file: enabled (default)")
+			}
+
+			// Check environment variables
+			envDisabled := false
+			envVars := []string{"VAPI_DISABLE_ANALYTICS", "VAPI_NO_TELEMETRY", "DISABLE_TELEMETRY", "DO_NOT_TRACK"}
+			for _, env := range envVars {
+				if os.Getenv(env) != "" {
+					fmt.Printf("  • Environment (%s): disabled\n", env)
+					envDisabled = true
+					break
+				}
+			}
+			if !envDisabled {
+				fmt.Println("  • Environment: enabled (default)")
+			}
+
+			fmt.Println()
+			fmt.Println("Data collected (when enabled):")
+			fmt.Println("  • Command usage patterns (anonymous)")
+			fmt.Println("  • Error types and frequencies (hashed)")
+			fmt.Println("  • Performance metrics")
+			fmt.Println("  • Operating system and architecture")
+			fmt.Println("  • CLI version information")
+			fmt.Println()
+			fmt.Println("Data NOT collected:")
+			fmt.Println("  • API keys or sensitive credentials")
+			fmt.Println("  • File contents or personal data")
+			fmt.Println("  • User-identifiable information")
+			fmt.Println("  • Specific error messages (only hashed patterns)")
+
+			return nil
+		}),
+	}
+
+	var analyticsEnableCmd = &cobra.Command{
+		Use:   "enable",
+		Short: "Enable analytics collection",
+		RunE: analytics.TrackCommandWrapper("config", "analytics-enable", func(cmd *cobra.Command, args []string) error {
+			cfg := config.GetConfig()
+			if cfg == nil {
+				cfg = &config.Config{}
+			}
+
+			cfg.DisableAnalytics = false
+
+			if err := config.SaveConfig(cfg); err != nil {
+				return fmt.Errorf("failed to save config: %w", err)
+			}
+
+			// Update global config
+			config.SetConfig(cfg)
+
+			fmt.Println("✅ Analytics enabled")
+			fmt.Println("   Anonymous usage data will be collected to help improve the CLI")
+			fmt.Println("   You can disable this anytime with: vapi config analytics disable")
+
+			return nil
+		}),
+	}
+
+	var analyticsDisableCmd = &cobra.Command{
+		Use:   "disable",
+		Short: "Disable analytics collection",
+		RunE: analytics.TrackCommandWrapper("config", "analytics-disable", func(cmd *cobra.Command, args []string) error {
+			cfg := config.GetConfig()
+			if cfg == nil {
+				cfg = &config.Config{}
+			}
+
+			cfg.DisableAnalytics = true
+
+			if err := config.SaveConfig(cfg); err != nil {
+				return fmt.Errorf("failed to save config: %w", err)
+			}
+
+			// Update global config
+			config.SetConfig(cfg)
+
+			fmt.Println("🚫 Analytics disabled")
+			fmt.Println("   No usage data will be collected")
+			fmt.Println("   You can re-enable this anytime with: vapi config analytics enable")
+
+			return nil
+		}),
+	}
+
+	analyticsCmd.AddCommand(analyticsStatusCmd)
+	analyticsCmd.AddCommand(analyticsEnableCmd)
+	analyticsCmd.AddCommand(analyticsDisableCmd)
+
+	configCmd.AddCommand(analyticsCmd)
+
 	// Here you will define your flags and configuration settings.
 
 	// Cobra supports Persistent Flags which will work for this command