name: cookidoo description: Manage Thermomix/Cookidoo meal planning via tmx-cli. Use for recipe search, weekly meal plan management, shopping list generation, favorites, and recipe details. Trigger when the user mentions Cookidoo, Thermomix, Wochenplan, meal plan, Rezept, recipe, or Einkaufsliste for cooking.

Cookidoo / tmx-cli Skill

Manage Cookidoo® (Thermomix) meal plans, recipes, and shopping lists using tmx-cli — a pure-Python CLI bundled in this skill at {baseDir}/tmx_cli.py.

Setup

1. Python 3.9+ required (no external dependencies)
2. Login: python3 {baseDir}/tmx_cli.py login (OAuth flow with Cookidoo account)
3. Setup (optional): python3 {baseDir}/tmx_cli.py setup — configure TM version, diet preferences, max cooking time

Critical Rules

1. Confirm before destructive actions (shopping clear, plan remove).
2. Use --json when parsing output programmatically.
3. Respect user preferences — setup config auto-applies to searches.

CLI Usage

python3 {baseDir}/../tmx-cli/tmx_cli.py <resource> <action> [options]

Core Workflows

Search Recipes

tmx search "Pasta" --json
tmx search "Kuchen" -n 20 --json              # more results
tmx search "Suppe" -t 30 --json               # max 30 min prep time
tmx search "Salat" -d easy -c vegetarisch --json  # easy + vegetarian

Filters: -t <minutes>, -d easy|medium|advanced, --tm TM5|TM6|TM7, -c <category>

Categories: vorspeisen, suppen, pasta, fleisch, fisch, vegetarisch, beilagen, desserts, herzhaft-backen, kuchen, brot, getraenke, grundrezepte, saucen, snacks

Recipe Details

tmx recipe show <recipe_id> --json   # ingredients, steps, nutrition

Meal Plan

tmx plan show --json                 # current week plan
tmx plan sync                        # sync from Cookidoo
tmx plan add <recipe_id> <day>       # add recipe (day: mon/tue/wed/thu/fri/sat/sun)
tmx plan remove <recipe_id> <day>    # remove from plan
tmx plan move <recipe_id> <from> <to>  # move between days

Shopping List

tmx shopping show --json             # current list
tmx shopping from-plan               # generate from meal plan
tmx shopping add <recipe_id>         # add recipe ingredients
tmx shopping add-item "Milch" "1L"   # add custom item
tmx shopping remove <recipe_id>      # remove recipe ingredients
tmx shopping clear                   # clear entire list ⚠️
tmx shopping export                  # export as markdown
tmx shopping export --format json    # export as JSON

Today's Recipes

tmx today --json                     # what's on the plan today

Favorites

tmx favorites show --json
tmx favorites add <recipe_id>
tmx favorites remove <recipe_id>

Full Command Reference

For all commands, options, and flags see {baseDir}/references/commands.md.