🥒 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 --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
• GitHub Repository