@mherod/get-cookie 4.3.2 → 4.4.0

package/examples/final-chrome-demo.sh

@@ -0,0 +1,115 @@
+#!/bin/bash
+
+# Final demonstration of Chrome cookie extraction with deduplication
+echo "🍪 get-cookie Chrome Integration Demo"
+echo "====================================="
+echo ""
+
+echo "✨ New Features Implemented:"
+echo "──────────────────────────"
+echo "1. Automatic cookie deduplication (keeps longest/most valid)"
+echo "2. --include-all flag to see all duplicates"
+echo "3. --include-expired flag to include expired cookies"
+echo ""
+
+# Show the improved Chrome cookie extraction
+echo "📊 Chrome Cookie Extraction:"
+echo "──────────────────────────"
+echo ""
+
+echo "Default behavior (deduplicated, non-expired only):"
+echo "$ get-cookie --url https://github.com --browser chrome --render"
+echo ""
+COOKIES=$(get-cookie --url https://github.com --browser chrome --render 2>/dev/null)
+echo "${COOKIES:0:100}..."
+echo "Total length: $(echo "$COOKIES" | wc -c) chars"
+echo ""
+
+# Show the cookie stats
+echo "Cookie Statistics:"
+DEFAULT_COUNT=$(get-cookie --url https://github.com --browser chrome --output json 2>/dev/null | jq 'length')
+ALL_COUNT=$(get-cookie --url https://github.com --browser chrome --output json --include-all 2>/dev/null | jq 'length')
+echo "  • Deduplicated cookies: $DEFAULT_COUNT"
+echo "  • All cookies (--include-all): $ALL_COUNT"
+echo "  • Duplicates removed: $((ALL_COUNT - DEFAULT_COUNT))"
+echo ""
+
+# Demonstrate the key improvement
+echo "🔑 Key Improvement: Session Cookie Handling"
+echo "──────────────────────────────────────────"
+echo ""
+echo "Problem: Chrome stores duplicate session cookies"
+echo "  • Invalid truncated: 'AJW' (3 chars)"
+echo "  • Valid full session: 'SgOohLA29269kO...' (48 chars)"
+echo ""
+echo "Solution: Automatic deduplication keeps the valid one:"
+SESSION=$(get-cookie user_session github.com --browser chrome --output json 2>/dev/null | jq -r '.[0].value')
+echo "  • Selected: ${SESSION:0:20}... (${#SESSION} chars) ✅"
+echo ""
+
+# Show practical usage patterns
+echo "💻 Practical Usage Patterns:"
+echo "──────────────────────────"
+echo ""
+
+echo "1. Simple cookie extraction for curl:"
+echo '   curl -H "Cookie: $(get-cookie --url <URL> --browser chrome --render)" <URL>'
+echo ""
+
+echo "2. JSON output for precise control:"
+echo '   get-cookie --url <URL> --browser chrome --output json | jq ...'
+echo ""
+
+echo "3. Debug duplicate cookies:"
+echo '   get-cookie --url <URL> --browser chrome --output json --include-all'
+echo ""
+
+echo "4. Include expired cookies (if needed):"
+echo '   get-cookie --url <URL> --browser chrome --render --include-expired'
+echo ""
+
+# Test with a simpler site
+echo "🧪 Testing with httpbin.org:"
+echo "──────────────────────────"
+echo ""
+
+# Set a test cookie in Chrome (this would need to be done manually)
+echo "Setting a test cookie and retrieving it:"
+echo '$ curl -c - "https://httpbin.org/cookies/set?test_cookie=hello_world"'
+echo ""
+
+# Try to get any httpbin cookies
+HTTPBIN_COOKIES=$(get-cookie % httpbin.org --browser chrome --output json 2>/dev/null | jq 'length')
+if [ "$HTTPBIN_COOKIES" -gt 0 ]; then
+    echo "Found $HTTPBIN_COOKIES httpbin.org cookies in Chrome"
+    get-cookie % httpbin.org --browser chrome --render
+else
+    echo "No httpbin.org cookies found (visit httpbin.org in Chrome to set some)"
+fi
+echo ""
+
+# Summary
+echo "📈 Performance Improvements:"
+echo "─────────────────────────"
+echo "• Eliminates duplicate cookies automatically"
+echo "• Filters expired cookies by default"
+echo "• Prioritizes valid cookies (longer values)"
+echo "• Backwards compatible with --include-all flag"
+echo ""
+
+echo "🔒 Note on GitHub Authentication:"
+echo "────────────────────────────────"
+echo "GitHub uses additional security measures beyond cookies:"
+echo "• IP address verification"
+echo "• User-Agent fingerprinting"
+echo "• Session binding to browser instance"
+echo "• CORS and referer checking"
+echo ""
+echo "For GitHub API access, use:"
+echo "• GitHub CLI: gh auth login"
+echo "• Personal Access Tokens"
+echo "• OAuth apps"
+echo ""
+
+echo "✅ Chrome cookie extraction is working perfectly!"
+echo "   The deduplication ensures you get valid, usable cookies."

package/examples/github-api.sh

@@ -0,0 +1,101 @@
+#!/bin/bash
+
+# Real-world example: Using get-cookie to access GitHub's authenticated endpoints
+# This demonstrates how browser cookies can be used for API automation
+
+echo "🔐 GitHub API Authentication with get-cookie"
+echo "============================================"
+
+# Get all relevant GitHub cookies using --render
+echo -e "\nExtracting GitHub cookies..."
+COOKIES=$(get-cookie % github.com --render 2>/dev/null | grep -E "(user_session|dotcom_user|__Host)" | paste -sd '; ')
+
+if [ -z "$COOKIES" ]; then
+    echo "❌ No GitHub cookies found. Please log into GitHub in your browser."
+    exit 1
+fi
+
+echo "✅ Found GitHub cookies"
+echo "   Cookie count: $(echo "$COOKIES" | grep -o ';' | wc -l | xargs expr 1 +)"
+
+# Test authentication with various GitHub endpoints
+echo -e "\n📊 Testing GitHub API endpoints:\n"
+
+# 1. User profile (public API, but returns more data when authenticated)
+echo "1. Fetching user profile..."
+USER_DATA=$(curl -s -H "Cookie: $COOKIES" https://api.github.com/user)
+LOGIN=$(echo "$USER_DATA" | jq -r '.login // empty')
+if [ -n "$LOGIN" ]; then
+    echo "   ✅ Authenticated as: @$LOGIN"
+    echo "   • Name: $(echo "$USER_DATA" | jq -r '.name // "N/A"')"
+    echo "   • Public repos: $(echo "$USER_DATA" | jq -r '.public_repos // 0')"
+    echo "   • Followers: $(echo "$USER_DATA" | jq -r '.followers // 0')"
+else
+    echo "   ⚠️ API authentication failed (cookies may not work for API)"
+fi
+
+# 2. Check notifications (requires authentication)
+echo -e "\n2. Checking notifications..."
+NOTIFICATIONS=$(curl -s -H "Cookie: $COOKIES" \
+    -H "Accept: application/vnd.github.v3+json" \
+    "https://api.github.com/notifications" | jq '. | length')
+if [ "$NOTIFICATIONS" != "null" ]; then
+    echo "   📬 Unread notifications: $NOTIFICATIONS"
+else
+    echo "   ⚠️ Could not fetch notifications"
+fi
+
+# 3. List private repos (if any)
+echo -e "\n3. Checking private repositories..."
+PRIVATE_REPOS=$(curl -s -H "Cookie: $COOKIES" \
+    "https://api.github.com/user/repos?type=private" | jq '. | length')
+if [ "$PRIVATE_REPOS" != "null" ] && [ "$PRIVATE_REPOS" != "0" ]; then
+    echo "   🔒 Private repositories: $PRIVATE_REPOS"
+else
+    echo "   ℹ️ No private repositories accessible"
+fi
+
+# 4. Recent activity
+echo -e "\n4. Fetching recent activity..."
+EVENTS=$(curl -s -H "Cookie: $COOKIES" \
+    "https://api.github.com/users/$LOGIN/events?per_page=5" | jq -r '.[] | "\(.type) in \(.repo.name)"' 2>/dev/null | head -5)
+if [ -n "$EVENTS" ]; then
+    echo "   Recent activity:"
+    echo "$EVENTS" | while read event; do
+        echo "   • $event"
+    done
+else
+    echo "   ⚠️ Could not fetch activity"
+fi
+
+# Practical example: Create a gist
+echo -e "\n💡 Example: Creating a gist with authentication"
+echo "──────────────────────────────────────────────"
+cat << 'EOF'
+curl -X POST \
+  -H "Cookie: $(get-cookie % github.com --render | grep -E 'user_session|__Host' | paste -sd '; ')" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "description": "Created via get-cookie + curl",
+    "public": false,
+    "files": {
+      "test.md": {
+        "content": "# Hello from get-cookie!\nThis gist was created using browser cookies."
+      }
+    }
+  }' \
+  https://api.github.com/gists
+EOF
+
+echo -e "\n🔍 Debugging tip:"
+echo "──────────────────"
+echo "If authentication fails, GitHub cookies might not work with the API."
+echo "GitHub's API primarily uses OAuth tokens, not browser session cookies."
+echo ""
+echo "To see what cookies you have:"
+echo "  get-cookie % github.com --dump"
+echo ""
+echo "To get just the cookie values:"
+echo "  get-cookie user_session github.com --render"
+echo ""
+echo "✅ Script complete!"

package/examples/github-private-access.sh

@@ -0,0 +1,118 @@
+#!/bin/bash
+
+# Accessing GitHub private content with browser cookies
+echo "🔓 GitHub Private Repository Access with get-cookie"
+echo "=================================================="
+echo ""
+
+# Get the full session cookie (not truncated ones)
+echo "Extracting valid GitHub session cookies..."
+FULL_SESSION=$(get-cookie user_session github.com --output json 2>/dev/null | jq -r '.[] | select(.value | length > 10) | .value' | head -1)
+
+if [ -z "$FULL_SESSION" ]; then
+    echo "❌ No valid GitHub session found. Please log into GitHub in Chrome."
+    exit 1
+fi
+
+echo "✅ Found valid session cookie (${#FULL_SESSION} characters)"
+echo ""
+
+# Build the cookie header with both required cookies
+COOKIE_HEADER="user_session=$FULL_SESSION; __Host-user_session_same_site=$FULL_SESSION"
+
+# Get username
+USERNAME=$(get-cookie dotcom_user github.com --output json 2>/dev/null | jq -r '.[0].value' | cut -d';' -f1)
+echo "👤 Logged in as: $USERNAME"
+echo ""
+
+echo "📊 Repository Statistics:"
+echo "────────────────────────"
+
+# Count repositories
+REPOS_HTML=$(curl -s -L \
+    -H "Cookie: $COOKIE_HEADER" \
+    -H "User-Agent: Mozilla/5.0" \
+    "https://github.com/$USERNAME?tab=repositories")
+
+PUBLIC_COUNT=$(echo "$REPOS_HTML" | grep -o '>Public<' | wc -l | xargs)
+PRIVATE_COUNT=$(echo "$REPOS_HTML" | grep -o '>Private<' | wc -l | xargs)
+
+echo "• Public repositories: $PUBLIC_COUNT"
+echo "• Private repositories: $PRIVATE_COUNT"
+echo "• Total: $((PUBLIC_COUNT + PRIVATE_COUNT))"
+echo ""
+
+echo "🔒 Private Repositories (first 5):"
+echo "──────────────────────────────────"
+
+# Extract private repo names
+echo "$REPOS_HTML" | grep -B3 '>Private<' | grep 'itemprop="name codeRepository"' | head -5 | while read line; do
+    REPO_NAME=$(echo "$line" | sed -n 's/.*href="[^"]*\/\([^"]*\)".*/\1/p')
+    if [ -n "$REPO_NAME" ]; then
+        echo "• $REPO_NAME"
+        
+        # Get repo details
+        REPO_PAGE=$(curl -s -L \
+            -H "Cookie: $COOKIE_HEADER" \
+            -H "User-Agent: Mozilla/5.0" \
+            "https://github.com/$USERNAME/$REPO_NAME")
+        
+        # Extract language if available
+        LANGUAGE=$(echo "$REPO_PAGE" | grep -o 'programmingLanguage">[^<]*' | head -1 | cut -d'>' -f2)
+        [ -n "$LANGUAGE" ] && echo "  Language: $LANGUAGE"
+        
+        # Count files
+        FILE_COUNT=$(echo "$REPO_PAGE" | grep -o 'js-navigation-open Link--primary' | wc -l | xargs)
+        [ "$FILE_COUNT" -gt 0 ] && echo "  Files/Folders visible: $FILE_COUNT"
+    fi
+done
+
+echo ""
+echo "🔑 Testing Access Levels:"
+echo "────────────────────────"
+
+# Test various authenticated endpoints
+test_access() {
+    local name=$1
+    local url=$2
+    echo -n "• $name: "
+    
+    CODE=$(curl -s -o /dev/null -w "%{http_code}" \
+        -H "Cookie: $COOKIE_HEADER" \
+        -H "User-Agent: Mozilla/5.0" \
+        "$url")
+    
+    if [ "$CODE" = "200" ]; then
+        echo "✅ Full access"
+    elif [ "$CODE" = "404" ]; then
+        echo "❌ Not found"
+    else
+        echo "⚠️  Limited access (HTTP $CODE)"
+    fi
+}
+
+test_access "Settings" "https://github.com/settings/profile"
+test_access "SSH Keys" "https://github.com/settings/keys"
+test_access "Security" "https://github.com/settings/security"
+test_access "Billing" "https://github.com/settings/billing"
+test_access "New Repository" "https://github.com/new"
+
+echo ""
+echo "💡 Practical Examples:"
+echo "────────────────────"
+echo ""
+echo "# Clone a private repository (using gh CLI):"
+echo "gh repo clone $USERNAME/<private-repo-name>"
+echo ""
+echo "# Download a file from a private repo:"
+echo "curl -H \"Cookie: user_session=\$SESSION; __Host-user_session_same_site=\$SESSION\" \\"
+echo "     https://github.com/$USERNAME/<private-repo>/raw/main/file.txt"
+echo ""
+echo "# Access private gist:"
+echo "curl -H \"Cookie: user_session=\$SESSION; __Host-user_session_same_site=\$SESSION\" \\"
+echo "     https://gist.github.com/$USERNAME/<gist-id>"
+echo ""
+echo "⚠️  Note: While we can VIEW private repos via the web interface,"
+echo "   cloning still requires proper Git authentication (SSH key or token)."
+echo ""
+echo "✅ Authentication successful! You have full web access to your private repos."

package/examples/list-profiles-demo.sh

@@ -0,0 +1,120 @@
+#!/bin/bash
+
+# Demonstration of the --list-profiles feature
+echo "🍪 Profile Listing Feature Demo"
+echo "==============================="
+echo ""
+
+echo "The new --list-profiles option helps you discover available browser profiles"
+echo "before using them with the --profile option."
+echo ""
+
+# Basic usage
+echo "📋 Basic Usage:"
+echo "─────────────"
+echo "$ get-cookie --browser chrome --list-profiles"
+echo ""
+get-cookie --browser chrome --list-profiles
+echo ""
+
+# Show how it integrates with profile selection
+echo "🔗 Integration with Profile Selection:"
+echo "────────────────────────────────────"
+echo ""
+echo "Step 1: List available profiles"
+echo "$ get-cookie --browser chrome --list-profiles"
+echo ""
+echo "Step 2: Use a specific profile name from the list"
+echo "$ get-cookie --url https://github.com --browser chrome --profile \"plugg.in\" --render"
+echo ""
+
+# Demonstrate actual usage
+echo "Example: Getting cookies from a specific profile"
+echo ""
+PROFILE_NAME="plugg.in"
+if get-cookie --browser chrome --list-profiles 2>/dev/null | grep -q "$PROFILE_NAME"; then
+    echo "✓ Profile '$PROFILE_NAME' found"
+    echo ""
+    echo "Getting GitHub session from '$PROFILE_NAME' profile:"
+    SESSION=$(get-cookie user_session github.com --browser chrome --profile "$PROFILE_NAME" --render 2>/dev/null)
+    if [ -n "$SESSION" ]; then
+        VALUE=$(echo "$SESSION" | cut -d'=' -f2)
+        echo "  user_session=${VALUE:0:20}... (${#VALUE} chars)"
+    else
+        echo "  No session cookie found"
+    fi
+else
+    echo "Profile '$PROFILE_NAME' not found"
+fi
+echo ""
+
+# Show error handling
+echo "⚠️  Error Handling:"
+echo "────────────────"
+echo ""
+echo "Without --browser flag:"
+echo "$ get-cookie --list-profiles"
+get-cookie --list-profiles 2>&1 | head -2
+echo ""
+
+echo "With unsupported browser:"
+echo "$ get-cookie --browser safari --list-profiles"
+get-cookie --browser safari --list-profiles 2>&1
+echo ""
+
+# Show all supported browsers
+echo "🌐 Supported Browsers:"
+echo "───────────────────"
+echo ""
+echo "Chromium-based browsers with profile support:"
+echo "  • chrome    - Google Chrome"
+echo "  • edge      - Microsoft Edge"
+echo "  • arc       - Arc Browser"
+echo "  • opera     - Opera"
+echo "  • opera-gx  - Opera GX"
+echo ""
+echo "Other browsers:"
+echo "  • firefox   - Profile listing coming soon"
+echo "  • safari    - No profile support (uses system keychain)"
+echo ""
+
+# Practical workflow
+echo "💼 Practical Workflow:"
+echo "───────────────────"
+echo ""
+cat << 'EOF'
+# 1. Check which profiles are available
+get-cookie --browser chrome --list-profiles
+
+# 2. Choose the profile with the right session
+#    (e.g., "Work" for company repos, "Personal" for personal)
+
+# 3. Extract cookies from that specific profile
+COOKIES=$(get-cookie --url https://github.com \
+          --browser chrome \
+          --profile "Work" \
+          --render)
+
+# 4. Use with curl for authenticated requests
+curl -H "Cookie: $COOKIES" https://github.com/company/private-repo
+EOF
+echo ""
+
+# Show JSON output option
+echo "📊 JSON Output Option:"
+echo "──────────────────"
+echo ""
+echo "For scripting, combine with JSON output:"
+echo '$ get-cookie --url https://example.com --browser chrome --profile "Work" --output json | jq ...'
+echo ""
+
+# Summary
+echo "✨ Summary:"
+echo "─────────"
+echo "• Use --list-profiles to discover available profiles"
+echo "• Profile names are shown with their directory mappings"
+echo "• User email is displayed when available"
+echo "• Works with all Chromium-based browsers"
+echo "• Essential for managing multiple logged-in sessions"
+echo ""
+echo "✅ The --list-profiles feature makes profile selection easy and discoverable!"

package/examples/proper-curl-usage.sh

@@ -0,0 +1,120 @@
+#!/bin/bash
+
+# PROPER usage of get-cookie with --url and --render for curl
+echo "✅ Correct get-cookie Usage with --url and --render"
+echo "==================================================="
+echo ""
+
+# The CORRECT way to use get-cookie with curl
+echo "📌 The Right Pattern:"
+echo "────────────────────"
+echo 'curl -H "Cookie: $(get-cookie --url <URL> --render)" <URL>'
+echo ""
+
+# Test 1: Simple check - what cookies do we get?
+echo "1️⃣ Checking cookies for GitHub settings:"
+COOKIES=$(get-cookie --url https://github.com/settings/profile --render 2>/dev/null)
+echo "   Cookie string length: $(echo "$COOKIES" | wc -c) characters"
+echo "   Number of cookies: $(echo "$COOKIES" | grep -o ';' | wc -l | xargs expr 1 +)"
+echo ""
+
+# Test 2: Real-world usage - accessing authenticated content
+echo "2️⃣ Testing authenticated access to GitHub:"
+echo ""
+
+test_url_with_cookies() {
+    local url=$1
+    local description=$2
+    
+    echo "• Testing: $description"
+    echo "  URL: $url"
+    
+    # Get cookies for this specific URL
+    local cookies=$(get-cookie --url "$url" --render 2>/dev/null)
+    
+    # Make the request
+    local response=$(curl -s -L \
+        -H "Cookie: $cookies" \
+        -H "User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36" \
+        -H "Accept: text/html,application/xhtml+xml" \
+        "$url")
+    
+    # Check if we're authenticated
+    if echo "$response" | grep -q "Sign in to GitHub" > /dev/null 2>&1; then
+        echo "  ❌ Not authenticated (redirected to login)"
+    elif echo "$response" | grep -q "<title>.*Settings.*</title>" > /dev/null 2>&1; then
+        echo "  ✅ Authenticated! (reached settings page)"
+    elif echo "$response" | grep -q "Your profile" > /dev/null 2>&1; then
+        echo "  ✅ Authenticated! (reached profile page)"
+    else
+        local title=$(echo "$response" | grep -o "<title>[^<]*</title>" | head -1)
+        echo "  ℹ️  Page title: $title"
+    fi
+    echo ""
+}
+
+# Test various GitHub pages
+test_url_with_cookies "https://github.com/settings/profile" "GitHub Settings"
+test_url_with_cookies "https://github.com/new" "New Repository Page"
+
+# Test 3: Working with other sites
+echo "3️⃣ Testing with other sites:"
+echo ""
+
+# Stack Overflow
+SO_COOKIES=$(get-cookie --url https://stackoverflow.com/users/edit --render 2>/dev/null)
+if [ -n "$SO_COOKIES" ]; then
+    echo "• Stack Overflow:"
+    SO_STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
+        -H "Cookie: $SO_COOKIES" \
+        -H "User-Agent: Mozilla/5.0" \
+        "https://stackoverflow.com/users/edit")
+    echo "  HTTP Status: $SO_STATUS"
+    [ "$SO_STATUS" = "200" ] && echo "  ✅ Authenticated" || echo "  ❌ Not authenticated"
+else
+    echo "• Stack Overflow: No cookies found"
+fi
+echo ""
+
+# Test 4: Practical one-liners
+echo "4️⃣ Practical One-Liners That Work:"
+echo "───────────────────────────────────"
+echo ""
+echo "# Download a file with authentication:"
+echo 'curl -O -H "Cookie: $(get-cookie --url https://example.com/file.pdf --render)" https://example.com/file.pdf'
+echo ""
+echo "# Check if you're logged in:"
+echo 'curl -s -H "Cookie: $(get-cookie --url https://github.com/settings --render)" https://github.com/settings | grep -q "Sign in" && echo "Not logged in" || echo "Logged in"'
+echo ""
+echo "# Save response with cookies:"
+echo 'curl -H "Cookie: $(get-cookie --url https://example.com --render)" https://example.com > page.html'
+echo ""
+
+# Test 5: Debugging when it doesn't work
+echo "5️⃣ Debugging Tips:"
+echo "─────────────────"
+echo ""
+echo "If authentication isn't working:"
+echo ""
+echo "1. Check cookie quality:"
+echo '   get-cookie --url <URL> --output json | jq '"'"'.[] | {name, value: .value[:20], len: (.value | length)}'"'"
+echo ""
+echo "2. Check for expired cookies:"
+echo '   get-cookie --url <URL> --output json | jq '"'"'.[] | select(.expiry < now | todate)'"'"
+echo ""
+echo "3. Try specific browser profiles:"
+echo '   get-cookie --url <URL> --browser chrome --render'
+echo ""
+
+# The key insight
+echo "⚠️  Important Note:"
+echo "──────────────────"
+echo "Some sites (like GitHub) may have multiple session cookies across different"
+echo "browser profiles. The --url flag gets ALL matching cookies, which may include"
+echo "invalid ones. For production use, you might need to:"
+echo ""
+echo "1. Use --browser to target a specific browser"
+echo "2. Use --output json and filter for valid cookies"
+echo "3. Check cookie expiration dates"
+echo ""
+echo "✅ The CLI is working correctly - it's faithfully extracting what the browsers have stored!"

package/examples/simple-curl.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+
+# Simple and practical get-cookie + curl integration using --render
+echo "🍪 get-cookie + curl Integration (using --render)"
+echo "=================================================="
+
+# The --render flag outputs cookies in the perfect format for curl: name=value
+
+# Example 1: Single cookie with curl
+echo -e "\n1️⃣ Getting GitHub user session cookie..."
+USER_SESSION=$(get-cookie user_session github.com --render 2>/dev/null)
+
+if [ -n "$USER_SESSION" ]; then
+    echo "   ✅ Got cookie: ${USER_SESSION:0:30}..."
+    
+    # Use directly with curl
+    echo -e "\n2️⃣ Using cookie with GitHub API..."
+    curl -s \
+        -H "Cookie: $USER_SESSION" \
+        -H "User-Agent: get-cookie-demo" \
+        "https://api.github.com/user" | jq -r '.login' | while read LOGIN; do
+        if [ -n "$LOGIN" ] && [ "$LOGIN" != "null" ]; then
+            echo "   ✅ Authenticated as: @$LOGIN"
+        else
+            echo "   ⚠️ Cookie didn't work for API (may need different cookie)"
+        fi
+    done
+else
+    echo "   ❌ No user_session cookie found"
+fi
+
+# Example 2: Multiple cookies (semicolon separated)
+echo -e "\n3️⃣ Getting multiple GitHub cookies..."
+COOKIES=""
+for cookie_name in "user_session" "dotcom_user" "__Host-user_session_same_site" "_gh_sess"; do
+    COOKIE=$(get-cookie "$cookie_name" github.com --render 2>/dev/null | head -1)
+    if [ -n "$COOKIE" ]; then
+        [ -n "$COOKIES" ] && COOKIES="$COOKIES; "
+        COOKIES="$COOKIES$COOKIE"
+        echo "   ✅ Added: ${cookie_name}"
+    fi
+done
+
+if [ -n "$COOKIES" ]; then
+    echo -e "\n4️⃣ Testing authenticated page access..."
+    HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" \
+        -H "Cookie: $COOKIES" \
+        -H "User-Agent: Mozilla/5.0" \
+        "https://github.com/settings/profile")
+    
+    echo "   HTTP Response: $HTTP_CODE"
+    [ "$HTTP_CODE" = "200" ] && echo "   ✅ Successfully accessed protected page!"
+fi
+
+# Example 3: Direct one-liner for API calls
+echo -e "\n5️⃣ One-liner examples:"
+echo "────────────────────"
+echo ""
+echo "# Get user info with single command:"
+echo 'curl -s -H "Cookie: $(get-cookie user_session github.com --render)" https://api.github.com/user | jq .login'
+echo ""
+
+echo "# Download file with authentication:"
+echo 'curl -H "Cookie: $(get-cookie user_session github.com --render)" -o file.zip https://github.com/user/repo/archive/main.zip'
+echo ""
+
+echo "# Using with wget:"
+echo 'wget --header="Cookie: $(get-cookie user_session github.com --render)" https://github.com/user/private-repo'
+echo ""
+
+echo "# Using with HTTPie:"
+echo 'http https://api.github.com/user "Cookie:$(get-cookie user_session github.com --render)"'
+
+# Example 4: Practical use case - checking star count
+echo -e "\n6️⃣ Practical example: Check if you've starred a repo..."
+COOKIE=$(get-cookie user_session github.com --render 2>/dev/null | head -1)
+if [ -n "$COOKIE" ]; then
+    STARRED=$(curl -s -H "Cookie: $COOKIE" \
+        -H "User-Agent: get-cookie-demo" \
+        "https://api.github.com/user/starred/mherod/get-cookie" \
+        -w "%{http_code}" -o /dev/null)
+    
+    if [ "$STARRED" = "204" ]; then
+        echo "   ⭐ You've starred mherod/get-cookie!"
+    elif [ "$STARRED" = "404" ]; then
+        echo "   ☆ You haven't starred mherod/get-cookie yet"
+    else
+        echo "   ⚠️ Couldn't check star status (HTTP $STARRED)"
+    fi
+fi
+
+echo -e "\n✅ Demo complete!"
+echo ""
+echo "💡 TIP: The --render flag outputs cookies in 'name=value' format,"
+echo "        perfect for direct use with curl's Cookie header!"