v0.1.7: Enhanced user experience and help system

- Enhanced version command with comprehensive system information
- Improved help text with better command descriptions and getting started guides
- Better root command with clear usage examples and resource links
- Enhanced login command with security information and alternative authentication
- Updated MCP setup examples with more relevant queries
- Improved MCP tool messages for better user guidance

Author: goosewin

VERSION

@@ -1 +1 @@
-0.1.6
+0.1.7

cmd/init.go

@@ -371,36 +371,43 @@ func runInitCommand(cmd *cobra.Command, args []string) error {
 	}
 
 	// Framework-specific instructions
-	switch project.ProjectType {
-	case integrations.ProjectTypeWeb:
-		fmt.Printf("%d. Import and use Vapi in your application\n", stepNum)
-		fmt.Println("   - Check the generated components in your project")
-		fmt.Println("   - Use the VapiButton component or useVapi hook")
-	case integrations.ProjectTypeBackend:
-		fmt.Printf("%d. Run the example code:\n", stepNum)
+	if project.ProjectType != integrations.ProjectTypeUnknown {
+		fmt.Printf("%d. Framework-specific setup:\n", stepNum)
+
 		switch project.Framework {
-		case integrations.FrameworkPython:
-			fmt.Println("   python vapi_examples/basic_example.py")
-		case integrations.FrameworkGolang:
-			fmt.Println("   go run examples/vapi/basic_example.go")
+		case integrations.FrameworkReact:
+			fmt.Println("   - Add the Vapi component to your app")
+			fmt.Println("   - Configure the voice interface in your main component")
+		case integrations.FrameworkNext:
+			fmt.Println("   - Add Vapi to your Next.js pages or components")
+			fmt.Println("   - Consider using the useVapi hook for state management")
 		case integrations.FrameworkNode:
-			if project.IsTypeScript {
-				fmt.Println("   npx tsx vapi-examples/basic-example.ts")
-			} else {
-				fmt.Println("   node vapi-examples/basic-example.js")
-			}
-		case integrations.FrameworkReact, integrations.FrameworkVue, integrations.FrameworkAngular,
-			integrations.FrameworkSvelte, integrations.FrameworkNext, integrations.FrameworkNuxt,
-			integrations.FrameworkRemix, integrations.FrameworkVanilla, integrations.FrameworkReactNative,
-			integrations.FrameworkFlutter, integrations.FrameworkRuby, integrations.FrameworkJava,
-			integrations.FrameworkCSharp, integrations.FrameworkUnknown:
-			fmt.Println("   Check the generated example code")
+			fmt.Println("   - Set up webhook endpoints for call events")
+			fmt.Println("   - Create assistant configuration and call management routes")
+		case integrations.FrameworkPython:
+			fmt.Println("   - Configure webhook handlers for call events")
+			fmt.Println("   - Set up assistant and call management endpoints")
 		}
-	case integrations.ProjectTypeMobile:
-		fmt.Printf("%d. Check the generated example code\n", stepNum)
-	case integrations.ProjectTypeUnknown:
-		fmt.Printf("%d. Check the Vapi documentation for integration instructions\n", stepNum)
+		fmt.Println()
+		stepNum++
 	}
+
+	// MCP Integration recommendation (v0.1.9 feature)
+	fmt.Printf("%d. 🧠 Set up IDE Integration (Recommended):\n", stepNum)
+	fmt.Println("   vapi mcp setup")
+	fmt.Println("   This turns your IDE into a Vapi expert with:")
+	fmt.Println("   • Real-time access to 138+ documentation pages")
+	fmt.Println("   • Smart code suggestions and examples")
+	fmt.Println("   • No more hallucinated API information")
+	fmt.Println("   • Works with Cursor, Windsurf, and VSCode")
+	fmt.Println()
+	stepNum++
+
+	// Testing and deployment
+	fmt.Printf("%d. Test and deploy:\n", stepNum)
+	fmt.Println("   - Test your voice integration locally")
+	fmt.Println("   - Set up webhooks for production")
+	fmt.Println("   - Deploy with your API keys configured")
 	fmt.Println()
 
 	// Offer to open documentation

cmd/login.go

@@ -27,19 +27,28 @@ import (
 	"github.com/VapiAI/cli/pkg/auth"
 )
 
-// Authenticate with Vapi via browser-based OAuth flow (alias for 'vapi auth login')
+// Authenticate with Vapi using browser-based login flow
 var loginCmd = &cobra.Command{
 	Use:   "login",
-	Short: "Authenticate with Vapi using browser-based login",
-	Long: `Opens your browser to authenticate with Vapi.
+	Short: "Authenticate with Vapi using secure browser login",
+	Long: `🔐 Authenticate with Vapi using secure browser-based login
 
-This secure authentication flow:
-1. Opens dashboard.vapi.ai in your browser
-2. Runs a local server to receive the auth token
-3. Saves your API key for future CLI commands
+This command will:
+1. Open your default browser to the Vapi authentication page
+2. Allow you to sign in with your existing Vapi account
+3. Automatically save your authentication credentials locally
+4. Enable access to all Vapi CLI features
 
-Note: This is an alias for 'vapi auth login'. For more authentication commands,
-see 'vapi auth --help'.`,
+🆕 New to Vapi? 
+  Sign up for free at: https://dashboard.vapi.ai
+
+🔑 Alternative Authentication:
+  You can also set your API key directly:
+  export VAPI_API_KEY=your_api_key_here
+
+🛡️  Security:
+  Your credentials are stored securely in your system's credential store
+  and are only used to authenticate with Vapi's APIs.`,
 	RunE: analytics.TrackCommandWrapper("auth", "login", func(cmd *cobra.Command, args []string) error {
 		fmt.Println("🔐 Authenticating with Vapi...")
 		fmt.Println()
@@ -50,12 +59,15 @@ see 'vapi auth --help'.`,
 			return err
 		}
 
-		fmt.Println("\nYou can now use all Vapi CLI commands.")
+		fmt.Println("\n✅ Authentication successful!")
+		fmt.Println()
+		fmt.Println("🎯 Next steps:")
 		fmt.Println("• List assistants: vapi assistant list")
 		fmt.Println("• View call history: vapi call list")
-		fmt.Println("• Integrate with projects: vapi init")
+		fmt.Println("• Initialize project: vapi init")
+		fmt.Println("• Set up IDE integration: vapi mcp setup")
 		fmt.Println()
-		fmt.Println("💡 For more auth commands, try: vapi auth --help")
+		fmt.Println("💡 For more commands, try: vapi --help")
 
 		return nil
 	}),

cmd/manual.go

@@ -27,6 +27,8 @@ import (
 	"github.com/spf13/cobra"
 	"github.com/spf13/cobra/doc"
 
+	"os/exec"
+
 	versionpkg "github.com/VapiAI/cli/pkg/version"
 )
 
@@ -41,6 +43,184 @@ var manualCmd = &cobra.Command{
 
 var manualOutputDir string
 
+// installManPagesCmd installs manual pages for the current user
+var installManPagesCmd = &cobra.Command{
+	Use:   "install-man-pages",
+	Short: "Install manual pages for the Vapi CLI",
+	Long: `Install Unix manual pages for the Vapi CLI to enable 'man vapi' command.
+
+This command will:
+1. Generate the latest manual pages for all commands
+2. Install them to the appropriate system location
+3. Update the manual database
+
+Requires administrative privileges for system-wide installation.`,
+	RunE: installManualPages,
+}
+
+func installManualPages(cmd *cobra.Command, args []string) error {
+	fmt.Printf("📖 Installing Vapi CLI manual pages...\n")
+
+	// Create a temporary directory for generated pages
+	tmpDir := filepath.Join(os.TempDir(), "vapi-man-pages")
+	if err := os.MkdirAll(tmpDir, 0o750); err != nil {
+		return fmt.Errorf("failed to create temporary directory: %w", err)
+	}
+	defer os.RemoveAll(tmpDir) // Clean up temp directory
+
+	// Generate man pages
+	fmt.Printf("   📝 Generating manual pages...\n")
+
+	header := &doc.GenManHeader{
+		Title:   "VAPI",
+		Section: "1",
+		Source:  fmt.Sprintf("Vapi CLI %s", versionpkg.Get()),
+		Manual:  "Vapi CLI Manual",
+		Date:    &[]time.Time{time.Now()}[0],
+	}
+
+	if err := doc.GenManTree(rootCmd, header, tmpDir); err != nil {
+		return fmt.Errorf("failed to generate man pages: %w", err)
+	}
+
+	// Find appropriate installation directory
+	manDir := getManPageInstallDir()
+	if manDir == "" {
+		return fmt.Errorf("could not find suitable man page directory")
+	}
+
+	// Check if directory exists and is writable
+	if err := ensureManDirWritable(manDir); err != nil {
+		fmt.Printf("   ⚠️  Need administrative privileges to install to %s\n", manDir)
+		fmt.Printf("   💡 Suggestions:\n")
+		fmt.Printf("      • Run with sudo: sudo vapi install-man-pages\n")
+		fmt.Printf("      • Or manually copy files from %s to %s\n", tmpDir, manDir)
+		return err
+	}
+
+	// Copy man pages to installation directory
+	fmt.Printf("   📋 Installing to %s...\n", manDir)
+
+	files, err := filepath.Glob(filepath.Join(tmpDir, "*.1"))
+	if err != nil {
+		return fmt.Errorf("failed to find generated man pages: %w", err)
+	}
+
+	for _, file := range files {
+		fileName := filepath.Base(file)
+		destPath := filepath.Join(manDir, fileName)
+
+		if err := copyFile(file, destPath); err != nil {
+			return fmt.Errorf("failed to copy %s: %w", fileName, err)
+		}
+
+		// Set appropriate permissions
+		if err := os.Chmod(destPath, 0o644); err != nil {
+			fmt.Printf("   ⚠️  Warning: failed to set permissions on %s\n", fileName)
+		}
+	}
+
+	// Update man database
+	fmt.Printf("   🔄 Updating manual database...\n")
+	if err := updateManDatabase(); err != nil {
+		fmt.Printf("   ⚠️  Warning: failed to update man database: %v\n", err)
+		fmt.Printf("   💡 You may need to run 'sudo mandb' manually\n")
+	}
+
+	fmt.Printf("   ✅ Installed %d manual page(s)\n", len(files))
+	fmt.Println()
+	fmt.Println("📚 Manual pages installed successfully!")
+	fmt.Println()
+	fmt.Println("🔍 Usage:")
+	fmt.Println("     man vapi          # Main CLI manual")
+	fmt.Println("     man vapi-call     # Call management")
+	fmt.Println("     man vapi-mcp      # MCP integration")
+	fmt.Println("     man vapi-assistant# Assistant management")
+	fmt.Println()
+	fmt.Println("💡 Try 'man vapi' to test the installation!")
+
+	return nil
+}
+
+func getManPageInstallDir() string {
+	// Check common man page directories in order of preference
+	candidates := []string{
+		"/usr/local/share/man/man1",    // Most common for user-installed tools
+		"/opt/homebrew/share/man/man1", // Homebrew on Apple Silicon
+		"/usr/share/man/man1",          // System-wide
+	}
+
+	for _, dir := range candidates {
+		if stat, err := os.Stat(dir); err == nil && stat.IsDir() {
+			return dir
+		}
+	}
+
+	return ""
+}
+
+func ensureManDirWritable(dir string) error {
+	// Check if directory exists
+	stat, err := os.Stat(dir)
+	if err != nil {
+		// Try to create the directory
+		if err := os.MkdirAll(dir, 0o755); err != nil {
+			return fmt.Errorf("directory does not exist and cannot be created: %w", err)
+		}
+		return nil
+	}
+
+	if !stat.IsDir() {
+		return fmt.Errorf("path exists but is not a directory")
+	}
+
+	// Test write permissions by creating a temporary file
+	testFile := filepath.Join(dir, ".vapi-test-write")
+	if file, err := os.Create(testFile); err != nil {
+		return fmt.Errorf("directory is not writable: %w", err)
+	} else {
+		file.Close()
+		os.Remove(testFile) // Clean up test file
+	}
+
+	return nil
+}
+
+func copyFile(src, dst string) error {
+	srcFile, err := os.Open(src)
+	if err != nil {
+		return err
+	}
+	defer srcFile.Close()
+
+	dstFile, err := os.Create(dst)
+	if err != nil {
+		return err
+	}
+	defer dstFile.Close()
+
+	_, err = srcFile.WriteTo(dstFile)
+	return err
+}
+
+func updateManDatabase() error {
+	// Try to update the man database
+	commands := [][]string{
+		{"mandb"},        // Most common
+		{"makewhatis"},   // Some systems
+		{"catman", "-w"}, // Alternative
+	}
+
+	for _, cmdArgs := range commands {
+		cmd := exec.Command(cmdArgs[0], cmdArgs[1:]...)
+		if err := cmd.Run(); err == nil {
+			return nil // Success
+		}
+	}
+
+	return fmt.Errorf("no suitable man database update command found")
+}
+
 func generateManualPages(cmd *cobra.Command, args []string) error {
 	fmt.Printf("📖 Generating manual pages for Vapi CLI v%s...\n", versionpkg.Get())
 
@@ -95,4 +275,5 @@ func init() {
 		"Output directory for generated manual pages")
 
 	rootCmd.AddCommand(manualCmd)
+	rootCmd.AddCommand(installManPagesCmd)
 }

cmd/mcp.go

@@ -541,17 +541,22 @@ func displayPostSetupInstructions() {
 	fmt.Println("4. Start a new chat and ask your AI assistant about Vapi!")
 	fmt.Println()
 	fmt.Println("Try asking your AI:")
-	fmt.Println("• \"How do I create a voice assistant with Vapi?\"")
-	fmt.Println("• \"Show me Vapi examples for phone calls\"")
-	fmt.Println("• \"What are the latest Vapi features?\"")
+	fmt.Println("• \"Find MCP server documentation for Claude Desktop configuration\"")
+	fmt.Println("• \"Show me Vapi examples for creating voice assistants\"")
+	fmt.Println("• \"How do I set up phone numbers and make outbound calls?\"")
+	fmt.Println("• \"What's the difference between function tools and MCP tools?\"")
+	fmt.Println("• \"Show me webhook configuration examples\"")
+	fmt.Println("• \"Find the latest Vapi API reference for assistants\"")
 	fmt.Println()
 	fmt.Println("Your IDE AI assistant now has access to:")
-	fmt.Println("• Complete Vapi documentation")
-	fmt.Println("• Code examples and templates")
-	fmt.Println("• Best practices and guides")
-	fmt.Println("• API reference and troubleshooting")
+	fmt.Println("• 138+ real documentation pages with actual content")
+	fmt.Println("• MCP server setup guides and Claude Desktop configuration")
+	fmt.Println("• Complete API reference with request/response examples")
+	fmt.Println("• Voice provider configurations (ElevenLabs, OpenAI, etc.)")
+	fmt.Println("• Real code examples from the official documentation")
+	fmt.Println("• Integration guides for tools, webhooks, and workflows")
 	fmt.Println()
-	fmt.Println("💡 Pro tip: Your AI will no longer hallucinate Vapi information!")
+	fmt.Println("💡 Pro tip: Use 'Find Vapi examples for [feature]' to get real code samples!")
 	fmt.Println()
 	fmt.Println("Need help? Check 'vapi mcp status' or visit https://docs.vapi.ai")
 }

cmd/root.go

@@ -84,11 +84,30 @@ func displayBanner() {
 	fmt.Println()
 }
 
-// The main CLI command that displays help when run without subcommands
+// rootCmd represents the base command when called without any subcommands
 var rootCmd = &cobra.Command{
 	Use:   "vapi",
-	Short: "Voice AI for developers - Vapi CLI",
-	Long:  `The official CLI for Vapi - build voice AI agents that make phone calls`,
+	Short: "Official Vapi CLI - Build voice AI applications with ease",
+	Long: `🎤 Vapi CLI - The official command-line interface for Vapi
+
+Build, deploy, and manage voice AI applications with the power of Vapi's platform.
+From simple voice assistants to complex phone call workflows, the Vapi CLI provides
+everything you need to create production-ready voice AI solutions.
+
+🚀 Getting Started:
+  vapi login                    # Authenticate with your Vapi account
+  vapi init                     # Initialize Vapi in your project
+  vapi mcp setup                # Set up IDE integration for better development
+
+🎯 Common Tasks:
+  vapi assistant list           # View your voice assistants
+  vapi call create             # Make outbound calls programmatically  
+  vapi phone list              # Manage phone numbers
+  vapi logs                    # View call logs and system events
+
+📚 Documentation: https://docs.vapi.ai
+💬 Community: https://discord.gg/vapi
+🐛 Issues: https://github.com/VapiAI/cli/issues`,
 	RunE: func(cmd *cobra.Command, args []string) error {
 		// Track command execution
 		startTime := time.Now()