docs: update README and generate CLI docs for auth/config commands

- Updated README.md Quick Start section to highlight interactive setup wizard
- Added new authentication and configuration verification sections
- Updated scripts/generate-cli-docs.sh to include auth and config commands
- Generated comprehensive CLI documentation for new commands:
  - auth/README.md, auth/test.md, auth/setup.md
  - config/README.md, config/show.md, config/path.md, config/validate.md
- Updated CLI reference index with new command categories

Makes authentication setup as easy as 'aws configure' experience.

Author: joshrotenberg

README.md

@@ -144,35 +144,76 @@ docker compose down -v
 
 ### 1. Configure Authentication
 
-#### Redis Cloud
+#### Option 1: Interactive Setup Wizard (Recommended)
 ```bash
-# Using environment variables
-export REDIS_CLOUD_API_KEY="your-api-key"
-export REDIS_CLOUD_API_SECRET="your-api-secret"
+# Launch guided setup for any deployment type
+redisctl auth setup
 
-# Or using profiles
-redisctl profile set prod-cloud \
-  --deployment-type cloud \
-  --api-key YOUR_KEY \
-  --api-secret YOUR_SECRET
+# Test your authentication
+redisctl auth test
 ```
 
-#### Redis Enterprise
+The interactive setup wizard will:
+- Guide you through credential collection
+- Test authentication during setup
+- Create and save working profiles
+- Set up your first profile as default
+
+#### Option 2: Manual Profile Creation
+
+##### Redis Cloud
 ```bash
-# Using environment variables
+# Create a Cloud profile manually
+redisctl profile set prod-cloud cloud \
+  --api-key "your-api-key" \
+  --api-secret "your-api-secret"
+
+# Set as default profile
+redisctl profile default prod-cloud
+```
+
+##### Redis Enterprise
+```bash
+# Create an Enterprise profile manually
+redisctl profile set prod-enterprise enterprise \
+  --url https://cluster:9443 \
+  --username [email protected] \
+  --password your-password
+```
+
+#### Option 3: Environment Variables
+```bash
+# Redis Cloud
+export REDIS_CLOUD_API_KEY="your-api-key"
+export REDIS_CLOUD_API_SECRET="your-api-secret"
+
+# Redis Enterprise
 export REDIS_ENTERPRISE_URL="https://cluster.example.com:9443"
-export REDIS_ENTERPRISE_USER="[email protected]"
+export REDIS_ENTERPRISE_USER="[email protected]"  
 export REDIS_ENTERPRISE_PASSWORD="your-password"
 
-# Or using profiles
-redisctl profile set prod-enterprise \
-  --deployment-type enterprise \
-  --url https://cluster:9443 \
-  --username admin \
-  --password secret
+# Test authentication works
+redisctl auth test
+```
+
+### 2. Verify Your Setup
+
+```bash
+# Test authentication for any profile or environment vars
+redisctl auth test
+redisctl auth test --profile prod-cloud
+
+# View your configuration
+redisctl config show
+
+# Validate all profiles  
+redisctl config validate
+
+# Find your config file location
+redisctl config path
 ```
 
-### 2. Basic Usage
+### 3. Basic Usage
 
 ```bash
 # List all profiles
@@ -194,7 +235,7 @@ redisctl database list -o json | jq '.[] | .name'
 redisctl database list -q "[?status=='active'].name" -o yaml
 ```
 
-### 3. Common Workflows
+### 4. Common Workflows
 
 ```bash
 # Initialize a new Enterprise cluster

docs/cli-reference/README.md

@@ -13,6 +13,8 @@ Commands:
   cluster     Cluster operations (smart routing)
   user        User operations (smart routing)
   account     Account operations (smart routing to Cloud subscriptions)
+  auth        Authentication testing and management
+  config      Configuration management
   help        Print this message or the help of the given subcommand(s)
 
 Options:

docs/cli-reference/auth/README.md

@@ -0,0 +1,16 @@
+# Authentication Management Commands
+
+```
+Authentication testing and management
+
+Usage: redisctl auth <COMMAND>
+
+Commands:
+  test   Test authentication credentials
+  setup  Interactive setup wizard for new profiles
+  help   Print this message or the help of the given subcommand(s)
+
+Options:
+  -h, --help  Print help
+```
+

docs/cli-reference/auth/setup.md

@@ -0,0 +1,11 @@
+# Auth Setup Command
+
+```
+Interactive setup wizard for new profiles
+
+Usage: redisctl auth setup
+
+Options:
+  -h, --help  Print help
+```
+

docs/cli-reference/auth/test.md

@@ -0,0 +1,13 @@
+# Auth Test Command
+
+```
+Test authentication credentials
+
+Usage: redisctl auth test [OPTIONS]
+
+Options:
+      --profile <PROFILE>        Profile to test (defaults to current profile)
+      --deployment <DEPLOYMENT>  Test a specific deployment type [possible values: cloud, enterprise]
+  -h, --help                     Print help
+```
+

docs/cli-reference/config/README.md

@@ -0,0 +1,17 @@
+# Configuration Management Commands
+
+```
+Configuration management
+
+Usage: redisctl config <COMMAND>
+
+Commands:
+  show      Show current configuration and active profile
+  path      Show configuration file path
+  validate  Validate configuration
+  help      Print this message or the help of the given subcommand(s)
+
+Options:
+  -h, --help  Print help
+```
+

docs/cli-reference/config/path.md

@@ -0,0 +1,11 @@
+# Config Path Command
+
+```
+Show configuration file path
+
+Usage: redisctl config path
+
+Options:
+  -h, --help  Print help
+```
+

docs/cli-reference/config/show.md

@@ -0,0 +1,12 @@
+# Config Show Command
+
+```
+Show current configuration and active profile
+
+Usage: redisctl config show [OPTIONS]
+
+Options:
+      --show-secrets  Show sensitive values (passwords, API keys)
+  -h, --help          Print help
+```
+

docs/cli-reference/config/validate.md

@@ -0,0 +1,12 @@
+# Config Validate Command
+
+```
+Validate configuration
+
+Usage: redisctl config validate [OPTIONS]
+
+Options:
+      --profile <PROFILE>  Profile to validate (defaults to all profiles)
+  -h, --help               Print help
+```
+

docs/cli-reference/index.md

@@ -47,6 +47,17 @@ Commands for managing configuration profiles:
 - [Remove Profile](profile/remove.md)
 - [Set Default](profile/default.md)
 
+### [Authentication Management](auth/README.md)
+Commands for testing and setting up authentication:
+- [Test Authentication](auth/test.md)
+- [Interactive Setup](auth/setup.md)
+
+### [Configuration Management](config/README.md)
+Commands for inspecting and validating configuration:
+- [Show Configuration](config/show.md)
+- [Configuration Path](config/path.md)
+- [Validate Configuration](config/validate.md)
+
 ### [Smart-Routed Commands](smart/)
 Commands that automatically detect deployment type:
 - [Database Operations](smart/database.md)