modbender 🥒 gurkerlcli - Austrian Grocery Shopping
Command-line interface for gurkerl.at online grocery shopping (Austria only).
Installation
# Via Homebrew
brew tap pasogott/tap
brew install gurkerlcli
# Or via pipx
pipx install gurkerlcli
Authentication
Login required before use:
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
export GURKERL_EMAIL=your-email@example.com
export GURKERL_PASSWORD=your-password
Or add to ~/.env.local for persistence.
Commands
🔍 Search Products
gurkerlcli search "bio milch"
gurkerlcli search "äpfel" --limit 10
gurkerlcli search "brot" --json # JSON output for scripting
🛒 Shopping Cart
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
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
gurkerlcli orders list # View past orders
Example Workflows
Check What's in the Cart
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
# Find product
gurkerlcli search "hafermilch"
# Add to cart (use product ID from search results)
gurkerlcli cart add 123456 -q 2
Remove Product from Cart
# 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:
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
--jsonflag 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)