@mherod/get-cookie 4.3.2 → 4.4.0

package/examples/curl-demo.sh

@@ -0,0 +1,102 @@
+#!/bin/bash
+
+# Simple demonstration of get-cookie + curl integration
+echo "🍪 get-cookie + curl Integration Demo"
+echo "======================================"
+
+# First, let's verify we have cookies
+echo -e "\n1️⃣ Checking available cookies..."
+COOKIE_COUNT=$(get-cookie % github.com --output json 2>/dev/null | jq 'length')
+echo "   Found $COOKIE_COUNT GitHub cookies"
+
+# Extract a specific cookie value
+echo -e "\n2️⃣ Extracting user_session cookie..."
+USER_SESSION=$(get-cookie user_session github.com --output json 2>/dev/null | jq -r '.[0].value' 2>/dev/null)
+
+if [ -n "$USER_SESSION" ] && [ "$USER_SESSION" != "null" ]; then
+    echo "   ✅ Got user_session cookie"
+    echo "   Value: ${USER_SESSION:0:20}... (truncated for security)"
+    
+    # Use the cookie with curl
+    echo -e "\n3️⃣ Making authenticated GitHub API request..."
+    RESPONSE=$(curl -s \
+        -H "Cookie: user_session=$USER_SESSION" \
+        -H "User-Agent: get-cookie-demo" \
+        "https://api.github.com/user")
+    
+    # Check if we got user data
+    LOGIN=$(echo "$RESPONSE" | jq -r '.login' 2>/dev/null)
+    if [ -n "$LOGIN" ] && [ "$LOGIN" != "null" ]; then
+        echo "   ✅ Authenticated as: @$LOGIN"
+        
+        # Get more user info
+        NAME=$(echo "$RESPONSE" | jq -r '.name' 2>/dev/null)
+        COMPANY=$(echo "$RESPONSE" | jq -r '.company' 2>/dev/null)
+        PUBLIC_REPOS=$(echo "$RESPONSE" | jq -r '.public_repos' 2>/dev/null)
+        
+        echo "   Name: $NAME"
+        [ "$COMPANY" != "null" ] && echo "   Company: $COMPANY"
+        echo "   Public repos: $PUBLIC_REPOS"
+    else
+        echo "   ⚠️ API did not return user data (cookie might not work for API)"
+    fi
+else
+    echo "   ❌ No user_session cookie found"
+fi
+
+# Example with multiple cookies
+echo -e "\n4️⃣ Building multi-cookie header..."
+COOKIES=""
+
+# Extract multiple cookies and combine them
+for cookie_name in "user_session" "dotcom_user" "__Host-user_session_same_site"; do
+    COOKIE_VALUE=$(get-cookie "$cookie_name" github.com --output json 2>/dev/null | jq -r '.[0].value' 2>/dev/null)
+    if [ -n "$COOKIE_VALUE" ] && [ "$COOKIE_VALUE" != "null" ]; then
+        [ -n "$COOKIES" ] && COOKIES="$COOKIES; "
+        COOKIES="$COOKIES$cookie_name=$COOKIE_VALUE"
+        echo "   ✅ Added $cookie_name"
+    fi
+done
+
+if [ -n "$COOKIES" ]; then
+    echo -e "\n5️⃣ Testing page access with cookies..."
+    # Test accessing a protected page
+    HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" \
+        -H "Cookie: $COOKIES" \
+        -H "User-Agent: Mozilla/5.0" \
+        "https://github.com/settings/profile")
+    
+    if [ "$HTTP_CODE" = "200" ]; then
+        echo "   ✅ Successfully accessed settings page (HTTP 200)"
+    elif [ "$HTTP_CODE" = "302" ] || [ "$HTTP_CODE" = "301" ]; then
+        echo "   ⚠️ Redirected (HTTP $HTTP_CODE) - might need more cookies"
+    else
+        echo "   ❌ Access failed (HTTP $HTTP_CODE)"
+    fi
+fi
+
+# Practical example: Download with authentication
+echo -e "\n6️⃣ Example: Downloading with authentication..."
+echo "   Command to download your GitHub avatar:"
+if [ -n "$LOGIN" ]; then
+    echo "   curl -H \"Cookie: user_session=\$COOKIE\" -o avatar.png https://github.com/$LOGIN.png"
+else
+    echo "   curl -H \"Cookie: user_session=\$COOKIE\" -o avatar.png https://github.com/USERNAME.png"
+fi
+
+# One-liner examples
+echo -e "\n📝 Useful one-liners:"
+echo "────────────────────"
+echo "# Get cookie value only:"
+echo "get-cookie user_session github.com --output json | jq -r '.[0].value'"
+echo ""
+echo "# Direct pipe to curl:"
+echo "curl -H \"Cookie: user_session=\$(get-cookie user_session github.com --output json | jq -r '.[0].value')\" https://api.github.com/user"
+echo ""
+echo "# Save all cookies to file:"
+echo "get-cookie % github.com --output json > github-cookies.json"
+echo ""
+echo "# Use with HTTPie instead of curl:"
+echo "http https://api.github.com/user \"Cookie:user_session=\$(get-cookie user_session github.com --output json | jq -r '.[0].value')\""
+
+echo -e "\n✅ Demo complete!"

package/examples/curl-integration.sh

@@ -0,0 +1,276 @@
+#!/bin/bash
+
+# ============================================================================
+# get-cookie + curl Integration Examples
+# 
+# This script demonstrates how to extract browser cookies and use them
+# with curl for authenticated API requests. This is useful for:
+# - Testing APIs with real authentication
+# - Automating tasks that require browser sessions
+# - Debugging authentication issues
+# ============================================================================
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Use the globally installed get-cookie binary
+GET_COOKIE="get-cookie"
+
+echo -e "${BLUE}🍪 get-cookie + curl Integration Examples${NC}"
+echo "================================================"
+
+# ============================================================================
+# Example 1: GitHub API with session cookie
+# ============================================================================
+echo -e "\n${YELLOW}Example 1: GitHub API Authentication${NC}"
+echo "----------------------------------------"
+
+# Extract GitHub session cookie
+echo -e "${GREEN}Extracting GitHub session cookie...${NC}"
+GITHUB_SESSION=$($GET_COOKIE user_session github.com 2>/dev/null | head -1)
+
+if [ -n "$GITHUB_SESSION" ]; then
+    echo "✓ Found GitHub session cookie"
+    
+    # Get current user info from GitHub API
+    echo -e "\n${GREEN}Fetching user info from GitHub API...${NC}"
+    RESPONSE=$(curl -s -H "Cookie: user_session=$GITHUB_SESSION" \
+                     -H "User-Agent: get-cookie-demo" \
+                     https://api.github.com/user)
+    
+    # Check if we got a valid response
+    if echo "$RESPONSE" | grep -q '"login"'; then
+        USERNAME=$(echo "$RESPONSE" | grep -o '"login":"[^"]*' | cut -d'"' -f4)
+        NAME=$(echo "$RESPONSE" | grep -o '"name":"[^"]*' | cut -d'"' -f4)
+        echo -e "${GREEN}✓ Successfully authenticated as: $NAME (@$USERNAME)${NC}"
+    else
+        echo -e "${RED}✗ Authentication failed - cookie might be expired${NC}"
+    fi
+else
+    echo -e "${RED}✗ No GitHub session cookie found${NC}"
+    echo "  Make sure you're logged into GitHub in Chrome/Firefox"
+fi
+
+# ============================================================================
+# Example 2: Multiple cookies for complex authentication
+# ============================================================================
+echo -e "\n${YELLOW}Example 2: Multiple Cookie Authentication${NC}"
+echo "----------------------------------------"
+
+# Some sites require multiple cookies for authentication
+# Extract all GitHub cookies and format for curl
+echo -e "${GREEN}Extracting all GitHub cookies...${NC}"
+
+# Get cookies in JSON format
+COOKIES_JSON=$($GET_COOKIE % github.com --output json 2>/dev/null)
+
+if [ -n "$COOKIES_JSON" ]; then
+    # Count cookies
+    COOKIE_COUNT=$(echo "$COOKIES_JSON" | jq 'length')
+    echo "✓ Found $COOKIE_COUNT GitHub cookies"
+    
+    # Build cookie header with multiple cookies
+    COOKIE_HEADER=$(echo "$COOKIES_JSON" | jq -r '.[] | "\(.name)=\(.value)"' | head -5 | paste -sd '; ')
+    
+    if [ -n "$COOKIE_HEADER" ]; then
+        echo -e "\n${GREEN}Testing with multiple cookies...${NC}"
+        # Make request with multiple cookies
+        STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
+                      -H "Cookie: $COOKIE_HEADER" \
+                      -H "User-Agent: get-cookie-demo" \
+                      https://github.com/settings/profile)
+        
+        if [ "$STATUS" = "200" ]; then
+            echo -e "${GREEN}✓ Successfully accessed protected page (HTTP $STATUS)${NC}"
+        else
+            echo -e "${RED}✗ Access denied (HTTP $STATUS)${NC}"
+        fi
+    fi
+else
+    echo -e "${RED}✗ Failed to extract cookies${NC}"
+fi
+
+# ============================================================================
+# Example 3: Download protected content
+# ============================================================================
+echo -e "\n${YELLOW}Example 3: Download Protected Content${NC}"
+echo "----------------------------------------"
+
+# Example: Download a file that requires authentication
+echo -e "${GREEN}Preparing authenticated download...${NC}"
+
+# Get session cookie for a specific domain
+DOMAIN="github.com"
+SESSION=$($GET_COOKIE user_session $DOMAIN 2>/dev/null | head -1)
+
+if [ -n "$SESSION" ]; then
+    echo "✓ Authentication cookie ready"
+    
+    # Example: Download user's avatar (requires authentication for private profiles)
+    echo -e "\n${GREEN}Example curl command for authenticated download:${NC}"
+    echo -e "${BLUE}curl -H \"Cookie: user_session=\$SESSION\" \\
+     -H \"User-Agent: YourApp\" \\
+     -o avatar.jpg \\
+     https://github.com/username.png${NC}"
+else
+    echo -e "${RED}✗ No session cookie available${NC}"
+fi
+
+# ============================================================================
+# Example 4: Function for easy cookie extraction
+# ============================================================================
+echo -e "\n${YELLOW}Example 4: Reusable Shell Function${NC}"
+echo "----------------------------------------"
+
+# Define a reusable function
+get_cookie_for_curl() {
+    local cookie_name=$1
+    local domain=$2
+    local cookie_value=$($GET_COOKIE "$cookie_name" "$domain" 2>/dev/null | head -1)
+    
+    if [ -n "$cookie_value" ]; then
+        echo "$cookie_name=$cookie_value"
+        return 0
+    else
+        echo ""
+        return 1
+    fi
+}
+
+# Demonstrate the function
+echo -e "${GREEN}Using reusable function to build cookie header...${NC}"
+
+# Build a cookie header with multiple specific cookies
+COOKIE_HEADER=""
+for cookie in "user_session" "dotcom_user" "_gh_sess"; do
+    if cookie_value=$(get_cookie_for_curl "$cookie" "github.com"); then
+        if [ -n "$COOKIE_HEADER" ]; then
+            COOKIE_HEADER="$COOKIE_HEADER; $cookie_value"
+        else
+            COOKIE_HEADER="$cookie_value"
+        fi
+        echo "  ✓ Added $cookie"
+    else
+        echo "  ✗ Skipped $cookie (not found)"
+    fi
+done
+
+if [ -n "$COOKIE_HEADER" ]; then
+    echo -e "\n${GREEN}Complete Cookie header for curl:${NC}"
+    echo -e "${BLUE}Cookie: $COOKIE_HEADER${NC}"
+fi
+
+# ============================================================================
+# Example 5: POST request with cookies
+# ============================================================================
+echo -e "\n${YELLOW}Example 5: POST Request with Authentication${NC}"
+echo "----------------------------------------"
+
+echo -e "${GREEN}Example: Creating a GitHub gist with authentication${NC}"
+
+# Get GitHub session
+SESSION=$($GET_COOKIE user_session github.com 2>/dev/null | head -1)
+CSRF=$($GET_COOKIE _gh_sess github.com 2>/dev/null | head -1)
+
+if [ -n "$SESSION" ]; then
+    echo -e "\n${BLUE}Example POST command:${NC}"
+    cat << 'EOF'
+curl -X POST \
+  -H "Cookie: user_session=$SESSION; _gh_sess=$CSRF" \
+  -H "Content-Type: application/json" \
+  -H "User-Agent: get-cookie-demo" \
+  -d '{
+    "description": "Created via API",
+    "public": false,
+    "files": {
+      "test.txt": {
+        "content": "Hello from get-cookie + curl!"
+      }
+    }
+  }' \
+  https://api.github.com/gists
+EOF
+else
+    echo -e "${RED}✗ Authentication cookies not available${NC}"
+fi
+
+# ============================================================================
+# Example 6: Cookie validation
+# ============================================================================
+echo -e "\n${YELLOW}Example 6: Cookie Validation${NC}"
+echo "----------------------------------------"
+
+validate_cookie() {
+    local domain=$1
+    local cookie_name=$2
+    
+    echo -e "${GREEN}Validating $cookie_name for $domain...${NC}"
+    
+    # Get cookie with metadata
+    COOKIE_JSON=$($GET_COOKIE "$cookie_name" "$domain" --output json 2>/dev/null)
+    
+    if [ -n "$COOKIE_JSON" ] && [ "$COOKIE_JSON" != "[]" ]; then
+        # Parse cookie details
+        EXPIRY=$(echo "$COOKIE_JSON" | jq -r '.[0].expiry' 2>/dev/null)
+        BROWSER=$(echo "$COOKIE_JSON" | jq -r '.[0].meta.browser' 2>/dev/null)
+        DECRYPTED=$(echo "$COOKIE_JSON" | jq -r '.[0].meta.decrypted' 2>/dev/null)
+        
+        echo "  ✓ Cookie found"
+        echo "    Browser: $BROWSER"
+        echo "    Decrypted: $DECRYPTED"
+        
+        # Check if expired
+        if [ "$EXPIRY" != "null" ] && [ "$EXPIRY" != "Infinity" ]; then
+            EXPIRY_TIMESTAMP=$(date -d "$EXPIRY" +%s 2>/dev/null || date -j -f "%Y-%m-%dT%H:%M:%S" "${EXPIRY%%.*}" +%s 2>/dev/null)
+            CURRENT_TIMESTAMP=$(date +%s)
+            
+            if [ -n "$EXPIRY_TIMESTAMP" ]; then
+                if [ "$EXPIRY_TIMESTAMP" -gt "$CURRENT_TIMESTAMP" ]; then
+                    DAYS_LEFT=$(( ($EXPIRY_TIMESTAMP - $CURRENT_TIMESTAMP) / 86400 ))
+                    echo "    Valid for: $DAYS_LEFT days"
+                else
+                    echo -e "    ${RED}⚠ EXPIRED${NC}"
+                fi
+            else
+                echo "    Expiry: $EXPIRY"
+            fi
+        else
+            echo "    Type: Session cookie"
+        fi
+        return 0
+    else
+        echo -e "  ${RED}✗ Cookie not found${NC}"
+        return 1
+    fi
+}
+
+# Validate some common cookies
+validate_cookie "github.com" "user_session"
+
+# ============================================================================
+# Tips and Best Practices
+# ============================================================================
+echo -e "\n${BLUE}📚 Tips and Best Practices${NC}"
+echo "================================================"
+echo "
+1. ${YELLOW}Security:${NC} Never log or save cookie values in scripts
+2. ${YELLOW}Expiration:${NC} Check cookie expiry before using them
+3. ${YELLOW}User-Agent:${NC} Always set a User-Agent header with curl
+4. ${YELLOW}CSRF Tokens:${NC} Some APIs require CSRF tokens in addition to session cookies
+5. ${YELLOW}Rate Limiting:${NC} Respect API rate limits when using automation
+
+${GREEN}Example one-liner to test authentication:${NC}
+${BLUE}get-cookie user_session github.com | xargs -I {} curl -s -H \"Cookie: user_session={}\" https://api.github.com/user | jq .login${NC}
+
+${GREEN}Example to save cookies to a file:${NC}
+${BLUE}get-cookie % domain.com --output json > cookies.json${NC}
+
+${GREEN}Example to use with wget instead of curl:${NC}
+${BLUE}wget --header=\"Cookie: \$(get-cookie session domain.com)\" https://domain.com/protected${NC}
+"
+
+echo -e "${GREEN}✅ Examples completed!${NC}"

package/examples/curl-with-url.sh

@@ -0,0 +1,136 @@
+#!/bin/bash
+
+# Ultimate get-cookie + curl integration using --url flag
+echo "🚀 get-cookie + curl: The Perfect Integration"
+echo "============================================="
+echo ""
+echo "The --url flag automatically gets all cookies for a specific URL!"
+echo ""
+
+# Example 1: Simple one-liner for any URL
+echo "1️⃣ One-liner to curl any URL with cookies:"
+echo "─────────────────────────────────────────"
+echo 'curl -H "Cookie: $(get-cookie --url https://github.com/settings/profile --render)" https://github.com/settings/profile'
+echo ""
+
+# Example 2: Function for easy authenticated requests
+authenticated_curl() {
+    local url=$1
+    shift  # Remove first argument, pass the rest to curl
+    
+    # Get cookies for this specific URL
+    local cookies=$(get-cookie --url "$url" --render 2>/dev/null)
+    
+    if [ -n "$cookies" ]; then
+        curl -H "Cookie: $cookies" "$@" "$url"
+    else
+        echo "No cookies found for $url" >&2
+        curl "$@" "$url"
+    fi
+}
+
+echo "2️⃣ Testing authenticated requests:"
+echo "──────────────────────────────────"
+
+# Test GitHub settings page
+echo "• GitHub Settings:"
+HTTP_CODE=$(authenticated_curl "https://github.com/settings/profile" -s -o /dev/null -w "%{http_code}")
+if [ "$HTTP_CODE" = "200" ]; then
+    echo "  ✅ Successfully accessed (HTTP 200)"
+elif [ "$HTTP_CODE" = "302" ]; then
+    echo "  ⚠️ Redirected to login (HTTP 302)"
+else
+    echo "  ❌ Failed (HTTP $HTTP_CODE)"
+fi
+
+# Test Stack Overflow profile
+echo "• Stack Overflow Profile:"
+HTTP_CODE=$(authenticated_curl "https://stackoverflow.com/users/edit/current" -s -o /dev/null -w "%{http_code}")
+if [ "$HTTP_CODE" = "200" ]; then
+    echo "  ✅ Successfully accessed (HTTP 200)"
+elif [ "$HTTP_CODE" = "302" ] || [ "$HTTP_CODE" = "404" ]; then
+    echo "  ⚠️ Not logged in or no profile (HTTP $HTTP_CODE)"
+else
+    echo "  ❌ Failed (HTTP $HTTP_CODE)"
+fi
+
+echo ""
+echo "3️⃣ Practical Examples:"
+echo "────────────────────"
+
+# Download a file with authentication
+echo "• Download authenticated content:"
+echo '  curl -H "Cookie: $(get-cookie --url https://example.com/private/file.pdf --render)" \\'
+echo '       -o file.pdf https://example.com/private/file.pdf'
+
+# POST request with cookies
+echo ""
+echo "• POST with authentication:"
+echo '  curl -X POST \\'
+echo '       -H "Cookie: $(get-cookie --url https://api.example.com/endpoint --render)" \\'
+echo '       -H "Content-Type: application/json" \\'
+echo '       -d '"'"'{"key": "value"}'"'"' \\'
+echo '       https://api.example.com/endpoint'
+
+# Follow redirects with cookies
+echo ""
+echo "• Follow redirects while maintaining cookies:"
+echo '  curl -L \\'
+echo '       -H "Cookie: $(get-cookie --url https://example.com/dashboard --render)" \\'
+echo '       https://example.com/dashboard'
+
+echo ""
+echo "4️⃣ Advanced Usage:"
+echo "─────────────────"
+
+# Show what cookies would be sent for different URLs
+echo "• Preview cookies for different URLs:"
+for url in "https://github.com/" "https://api.github.com/" "https://gist.github.com/"; do
+    COOKIE_COUNT=$(get-cookie --url "$url" --output json 2>/dev/null | jq 'length // 0')
+    echo "  $url → $COOKIE_COUNT cookies"
+done
+
+echo ""
+echo "5️⃣ Shell Function for Your .bashrc/.zshrc:"
+echo "──────────────────────────────────────────"
+cat << 'EOF'
+# Add to your shell config for easy authenticated requests
+auth_curl() {
+    local url=$1
+    shift
+    curl -H "Cookie: $(get-cookie --url "$url" --render 2>/dev/null)" "$@" "$url"
+}
+
+# Usage: auth_curl https://github.com/settings/profile -s | grep username
+EOF
+
+echo ""
+echo "6️⃣ Comparison: Manual vs --url flag:"
+echo "────────────────────────────────────"
+echo "❌ Manual (need to know domain and cookie names):"
+echo '  get-cookie user_session github.com --render'
+echo ""
+echo "✅ With --url (automatic):"
+echo '  get-cookie --url https://github.com/settings/profile --render'
+echo ""
+echo "The --url flag automatically:"
+echo "  • Extracts the domain from the URL"
+echo "  • Gets ALL relevant cookies for that domain"
+echo "  • Handles subdomains correctly"
+echo "  • Returns cookies in the right format for curl"
+
+echo ""
+echo "7️⃣ Real Example - Download your GitHub avatar:"
+echo "──────────────────────────────────────────────"
+USERNAME=$(get-cookie dotcom_user github.com --render 2>/dev/null | cut -d'=' -f2 | cut -d';' -f1)
+if [ -n "$USERNAME" ]; then
+    echo "Downloading avatar for: $USERNAME"
+    echo "Command:"
+    echo "  curl -H \"Cookie: \$(get-cookie --url https://github.com/$USERNAME.png --render)\" \\"
+    echo "       -o avatar.png https://github.com/$USERNAME.png"
+else
+    echo "Not logged into GitHub"
+fi
+
+echo ""
+echo "✅ The --url flag makes cookie extraction automatic and foolproof!"

package/examples/deduplication-demo.sh

@@ -0,0 +1,110 @@
+#!/bin/bash
+
+# Demonstration of the new cookie deduplication feature
+echo "🍪 Cookie Deduplication Feature Demo"
+echo "===================================="
+echo ""
+echo "This demo shows how get-cookie now handles duplicate cookies"
+echo "from Chrome profiles by default, keeping the most valid one."
+echo ""
+
+# Show the problem
+echo "1️⃣ The Problem: Chrome Duplicate Cookies"
+echo "────────────────────────────────────────"
+echo "Chrome can store duplicate cookies from different profiles."
+echo "Let's see what happens with --include-all (old behavior):"
+echo ""
+
+echo "Command: get-cookie user_session github.com --browser chrome --output json --include-all"
+echo ""
+get-cookie user_session github.com --browser chrome --output json --include-all 2>/dev/null | \
+    jq -r '.[] | "  • Value: \(.value[0:20])... (\(.value | length) chars)"'
+echo ""
+
+# Show the solution
+echo "2️⃣ The Solution: Automatic Deduplication (Default)"
+echo "──────────────────────────────────────────────────"
+echo "By default, get-cookie now keeps only the most valid cookie:"
+echo ""
+
+echo "Command: get-cookie user_session github.com --browser chrome --output json"
+echo ""
+get-cookie user_session github.com --browser chrome --output json 2>/dev/null | \
+    jq -r '.[] | "  • Value: \(.value[0:20])... (\(.value | length) chars)"'
+echo ""
+
+# Demonstrate the render difference
+echo "3️⃣ Impact on --render Output"
+echo "───────────────────────────"
+echo ""
+
+echo "With --include-all (all duplicates):"
+RENDER_ALL=$(get-cookie user_session github.com --browser chrome --render --include-all 2>/dev/null)
+echo "  ${RENDER_ALL:0:60}..."
+echo "  Length: $(echo "$RENDER_ALL" | wc -c) chars"
+echo ""
+
+echo "Default (deduplicated):"
+RENDER_DEDUP=$(get-cookie user_session github.com --browser chrome --render 2>/dev/null)
+echo "  $RENDER_DEDUP"
+echo "  Length: $(echo "$RENDER_DEDUP" | wc -c) chars"
+echo ""
+
+# Show how it works with curl
+echo "4️⃣ Using with curl"
+echo "────────────────"
+echo "The deduplication ensures curl gets the valid cookie:"
+echo ""
+
+echo "Command: curl -H \"Cookie: \$(get-cookie --url <URL> --browser chrome --render)\" <URL>"
+echo ""
+echo "Example for GitHub:"
+COOKIES=$(get-cookie --url https://github.com --browser chrome --render 2>/dev/null)
+echo "  Cookie count: $(echo "$COOKIES" | grep -o ';' | wc -l | xargs expr 1 +)"
+echo "  user_session value length: $(echo "$COOKIES" | grep -o 'user_session=[^;]*' | cut -d'=' -f2 | wc -c) chars"
+echo ""
+
+# Show all duplicates
+echo "5️⃣ Viewing All Duplicates"
+echo "───────────────────────"
+echo "To see all duplicate cookies (for debugging), use --include-all:"
+echo ""
+
+echo "Command: get-cookie % github.com --browser chrome --output json --include-all"
+echo ""
+echo "Duplicate cookie names found:"
+get-cookie % github.com --browser chrome --output json --include-all 2>/dev/null | \
+    jq -r '[.[] | .name] | group_by(.) | map(select(length > 1)) | map(.[0]) | .[]' | \
+    sort | uniq | while read name; do
+        COUNT=$(get-cookie "$name" github.com --browser chrome --output json --include-all 2>/dev/null | jq 'length')
+        if [ "$COUNT" -gt 1 ]; then
+            echo "  • $name: $COUNT copies"
+        fi
+    done
+echo ""
+
+# Summary
+echo "📊 Summary"
+echo "────────"
+echo ""
+
+# Count cookies with and without deduplication
+TOTAL_ALL=$(get-cookie % github.com --browser chrome --output json --include-all 2>/dev/null | jq 'length')
+TOTAL_DEDUP=$(get-cookie % github.com --browser chrome --output json 2>/dev/null | jq 'length')
+REMOVED=$((TOTAL_ALL - TOTAL_DEDUP))
+
+echo "Chrome cookies for github.com:"
+echo "  • With --include-all: $TOTAL_ALL cookies"
+echo "  • Default (deduplicated): $TOTAL_DEDUP cookies"
+echo "  • Duplicates removed: $REMOVED"
+echo ""
+
+echo "💡 Key Points:"
+echo "────────────"
+echo "• Deduplication is ON by default (keeps longest/newest cookie)"
+echo "• Use --include-all to see all duplicates"
+echo "• Combines with --include-expired for complete control"
+echo "• Solves the Chrome \"truncated cookie\" problem"
+echo ""
+
+echo "✅ The deduplication feature ensures you get valid cookies for authentication!"