Picnic

The primary use case is planning a full week of meals. Follow this order:

1. Check Rules

picnic rules

Rules tell you how to plan. Key rule types:

• week rules: meal structure (3 meals x 2 days), variety constraints, standard recipes to always add
• recipe rules: what makes a good recipe (quick, child-friendly, seasonal, etc.)
• product rules: how to pick ingredients (prefer bio, always Mutti, brown rice, etc.)

2. Check Previous Orders (Avoid Repeats)

picnic deliveries                    # find recent delivery IDs
picnic delivery <id> --verbose       # see what was ordered

3. Browse This Week's Recipes First

picnic recipes                       # this week's Picnic menu
picnic recipes --all                 # all recipes from meals page

4. Search for Specific Recipes

picnic recipe-search "zalm"          # search full recipe catalog
picnic recipe-search "stamppot"

The response includes results (recipes) and rules (recipe + week rules to consider).

5. Get Recipe Details

picnic recipe <id>

Response includes:

• ingredients — items to buy (CORE, CORE_STOCKABLE, VARIATION)
• assumedAtHome — pantry staples (oil, salt, pepper, garlic) — skip these
• rules — product rules to apply when selecting ingredients

6. Add Ingredients with Recipe Linking

picnic recipe-add <productId> <recipeId> [qty] \
  --ingredient-id <uuid> \
  --ingredient-type CORE \
  --day-offset 0 \
  --servings 4

Always include --ingredient-id and --ingredient-type from the recipe detail so products are linked to the recipe in the Picnic app.

Use --day-offset to assign meals to days (0 = delivery day, 2 = two days later, etc.).

7. Apply Product Rules When Adding

When adding ingredients, apply rules from the response:

Overrides (must follow):

• Swap tomato products for Mutti brand
• Use brown rice / whole wheat pasta instead of white
• Use whole onions instead of pre-cut
• Use beef mince instead of pork/mixed
• Choose no-salt-added spice blends

Preferences (ask first):

• Prefer bio products — search for "bio <product>" alternatives
• Prefer store brands (Picnic brand)
• Prefer individual spices over pre-made mixes
• Check cart for eggs/apples before adding more
• Ask about pantry staples (ginger, milk, garlic, spices)
• Prefer naan bread when available as variation
• Suggest extra vegetables from variations

8. Add Standard Weekly Items

Always add these own recipes (overrides):

• Wraps (409f1c9d025040098f055550b08d720b) — weekly lunch
• Standaard stuff (b91938aace3a4f9281490f936664826d) — weekly pantry stock

Ask before adding:

• Voorraadkast (11d7cd160b174a169f6874be21d68921) — not needed every week

9. Review Cart

picnic cart

The cart response includes week rules. Verify:

• No duplicate cuisine types in the week
• Salmon included if possible
• Weekend oven dish if both partners are home (check calendars)

All Commands

Tips

• Always check picnic status before other commands
• Check picnic rules at the start of a planning session — rules are embedded in responses but reading them upfront helps
• Browse picnic recipes (this week's menu) and new recipes before doing generic searches
• Product IDs come from search results or recipe details
• Slot IDs come from picnic slots
• All output is JSON; add --pretty for human-readable tables
• Use --verbose to see full API responses (useful for debugging)
• When searching, try Dutch terms (e.g., "halfvolle melk" not "milk")
• Cupboard items in recipes are already filtered to assumedAtHome — don't add those
• Unavailability warnings are hidden when no slot is selected (prices show as 999.99 placeholder)