gurkerlcli

# 🥒 gurkerlcli - Austrian Grocery Shopping Command-line interface for [gurkerl.at](https://gurkerl.at) online grocery shopping (Austria only). ## Installation ```bash # Via Homebrew brew tap pasogott/tap brew install gurkerlcli # Or via pipx pipx install gurkerlcli ``` ## Authentication **Login required before use:** ```bash gurkerlcli auth login --email user@example.com --password xxx gurkerlcli auth whoami # Check login status gurkerlcli auth logout # Clear session ``` Session is stored securely in macOS Keychain. **Alternative: Environment variables** ```bash export GURKERL_EMAIL=your-email@example.com export GURKERL_PASSWORD=your-password ``` Or add to `~/.env.local` for persistence. ## Commands ### 🔍 Search Products ```bash gurkerlcli search "bio milch" gurkerlcli search "äpfel" --limit 10 gurkerlcli search "brot" --json # JSON output for scripting ``` ### 🛒 Shopping Cart ```bash gurkerlcli cart list # View cart contents gurkerlcli cart add <product_id> # Add product gurkerlcli cart add <product_id> -q 3 # Add with quantity gurkerlcli cart remove <product_id> # Remove product gurkerlcli cart clear # Empty cart (asks for confirmation) gurkerlcli cart clear --force # Empty cart without confirmation ``` ### 📝 Shopping Lists ```bash gurkerlcli lists list # Show all lists gurkerlcli lists show <list_id> # Show list details gurkerlcli lists create "Wocheneinkauf" # Create new list gurkerlcli lists delete <list_id> # Delete list ``` ### 📦 Order History ```bash gurkerlcli orders list # View past orders ``` ## Example Workflows ### Check What's in the Cart ```bash gurkerlcli cart list ``` Output: ``` 🛒 Shopping Cart ┌─────────────────────────────────┬──────────────┬───────────────┬──────────┐ │ Product │ Qty │ Price │ Subtotal │ ├─────────────────────────────────┼──────────────┼───────────────┼──────────┤ │ 🥛 nöm BIO-Vollmilch 3,5% │ 2x 1.0 l │ €1.89 → €1.70 │ €3.40 │ │ 🧀 Bergbaron │ 1x 150 g │ €3.99 │ €3.99 │ ├─────────────────────────────────┼──────────────┼───────────────┼──────────┤ │ │ │ Total: │ €7.39 │ └─────────────────────────────────┴──────────────┴───────────────┴──────────┘ ⚠️ Minimum order: €39.00 (€31.61 remaining) ``` ### Search and Add to Cart ```bash # Find product gurkerlcli search "hafermilch" # Add to cart (use product ID from search results) gurkerlcli cart add 123456 -q 2 ``` ### Remove Product from Cart ```bash # List cart to see product IDs gurkerlcli cart list --json | jq '.items[].product_id' # Remove specific product gurkerlcli cart remove 123456 ``` ## Debugging Use `--debug` flag for verbose output: ```bash gurkerlcli cart add 12345 --debug gurkerlcli cart remove 12345 --debug ``` ## Tips - **Minimum order:** €39.00 for delivery - **Delivery slots:** Check gurkerl.at website for available times - **Sale items:** Prices with arrows (€1.89 → €1.70) indicate discounts - **JSON output:** Use `--json` flag for scripting/automation ## Limitations - ⏳ Checkout not yet implemented (use website) - 🇦🇹 Austria only (Vienna, Graz, Linz areas) - 🔐 Requires active gurkerl.at account ## Changelog - **v0.1.6** - Fix cart remove (use DELETE instead of POST) - **v0.1.5** - Fix cart add for existing items (use POST instead of PUT) ## Links - [gurkerl.at](https://gurkerl.at) - [GitHub Repository](https://github.com/pasogott/gurkerlcli)