/install gurkerlcli
🥒 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 [email protected] --password xxx
gurkerlcli auth whoami # Check login status
gurkerlcli auth logout # Clear session
Session is stored securely in macOS Keychain.
Alternative: Environment variables
export [email protected]
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 \x3Cproduct_id> # Add product
gurkerlcli cart add \x3Cproduct_id> -q 3 # Add with quantity
gurkerlcli cart remove \x3Cproduct_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 \x3Clist_id> # Show list details
gurkerlcli lists create "Wocheneinkauf" # Create new list
gurkerlcli lists delete \x3Clist_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)
Links
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gurkerlcli - After installation, invoke the skill by name or use
/gurkerlcli - Provide required inputs per the skill's parameter spec and get structured output
What is gurkerlcli?
Austrian online grocery shopping via gurkerl.at. Use when user asks about "groceries", "Einkauf", "Lebensmittel bestellen", "Gurkerl", shopping cart, or wants to search/order food online in Austria. It is an AI Agent Skill for Claude Code / OpenClaw, with 2011 downloads so far.
How do I install gurkerlcli?
Run "/install gurkerlcli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is gurkerlcli free?
Yes, gurkerlcli is completely free (open-source). You can download, install and use it at no cost.
Which platforms does gurkerlcli support?
gurkerlcli is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created gurkerlcli?
It is built and maintained by pasogott (@pasogott); the current version is v0.1.6.