refactor(examples): consolidate 18 example scripts into 4 guides

.husky/pre-push

@@ -1,3 +1,18 @@
+# Load nvm if available
+export NVM_DIR="$HOME/.nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+
+# Use Node version from .nvmrc if it exists
+[ -f .nvmrc ] && nvm use
+
+# Ensure nvm's Node takes precedence in PATH
+if [ -n "$NVM_DIR" ] && [ -d "$NVM_DIR/versions/node" ]; then
+  NODE_VERSION=$(nvm version)
+  if [ -n "$NODE_VERSION" ] && [ "$NODE_VERSION" != "system" ]; then
+    export PATH="$NVM_DIR/versions/node/$NODE_VERSION/bin:$PATH"
+  fi
+fi
+
 # Try pnpm first, fallback to npx if pnpm not found
 if command -v pnpm >/dev/null 2>&1; then
   pnpm run validate

docs/.vitepress/config.mjs

@@ -50,6 +50,7 @@ export default defineConfig({
         {
           text: "Essential Guides",
           items: [
+            { text: "📚 Examples & Tutorials", link: "/guide/examples" },
             { text: "🛡️ Security & Privacy", link: "/guide/security" },
             { text: "🔍 Troubleshooting", link: "/guide/troubleshooting" },
             { text: "💻 CLI Usage", link: "/guide/cli-usage" },

docs/automation/index.md

@@ -102,12 +102,14 @@ const cookies = await getCookie({
 
 ## Next Steps
 
+- [📚 View Complete Examples →](/guide/examples) - Comprehensive working examples
 - [Start with Shell Scripts →](/automation/shell-scripts)
 - [Read Browser Automation Guide →](/automation/browser-automation)
 - [Check the API Reference →](/reference/)
 
 ## Need Help?
 
+- [📚 Examples & Tutorials →](/guide/examples) - Complete working examples
 - [Check the Troubleshooting Guide →](/guide/troubleshooting)
 - [Review Security Best Practices →](/guide/security)
 - [Read API Documentation →](/reference/)

docs/automation/shell-scripts.md

@@ -1,6 +1,6 @@
 # Shell Script Automation 📜
 
-Learn how to automate tasks with get-cookie using shell scripts.
+Learn how to automate tasks with get-cookie using shell scripts. For complete working examples, see the [Examples Guide](../guide/examples.md) and the `examples/` directory in the repository.
 
 ## Basic Scripts
 
@@ -310,3 +310,14 @@ debug "Cookie result: ${cookie:0:10}..."
    export COOKIE_HASH=$(echo "$cookie" | sha256sum)
    # Use COOKIE_HASH for tracking, not the actual cookie
    ```
+
+## Example Scripts
+
+For comprehensive shell script examples, see:
+
+- **[Quick Start Examples](../guide/examples.md#quick-start-examples)** - Essential patterns and reusable functions
+- **[curl Integration Examples](../guide/examples.md#curl-integration-examples)** - Complete curl integration guide
+- **[GitHub Authentication Examples](../guide/examples.md#github-authentication-examples)** - GitHub-specific patterns
+- **[CLI Features Examples](../guide/examples.md#cli-features-examples)** - All CLI feature demonstrations
+
+All example scripts are available in the `examples/` directory of the repository.

docs/guide/cli-usage.md

@@ -275,6 +275,16 @@ if [ -n "$AUTH_COOKIE" ]; then
 fi
 ```
 
+## Complete Examples
+
+For comprehensive examples covering all CLI features and use cases, see:
+
+- **[Examples & Tutorials Guide](./examples.md)** - Complete working examples
+- **Quick Start:** `examples/quick-start.sh` - Essential patterns
+- **curl Integration:** `examples/curl-integration.sh` - Comprehensive curl guide
+- **GitHub Auth:** `examples/github-auth.sh` - GitHub authentication patterns
+- **CLI Features:** `examples/features-demo.sh` - All feature demonstrations
+
 ## Error Handling
 
 The CLI uses exit codes to indicate status: