tmx-cli

# 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
```bash
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
```bash
tmx recipe show <recipe_id> --json   # ingredients, steps, nutrition
```

### Meal Plan
```bash
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
```bash
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
```bash
tmx today --json                     # what's on the plan today
```

### Favorites
```bash
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`.