pp-anylist

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/food-and-dining/anylist/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# AnyList — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `anylist-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install anylist --cli-only
   ```
2. Verify: `anylist-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/food-and-dining/anylist/cmd/anylist-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## When to Use This CLI

Use anylist-pp-cli when you need to automate grocery and meal planning workflows from the shell or in agent pipelines. It excels at cron-based shopping list generation from meal plans, offline recipe search by ingredient or metadata, and store-optimized shopping output. It is the right choice when you need JSON output from AnyList operations for downstream processing with jq, or when you want to build Home Assistant / n8n automations beyond what the basic hacs-anylist integration supports.

## Unique Capabilities

These capabilities aren't available in any other tool for this API.

### Local state that compounds

- **`recipes search --ingredient`** — Find every recipe that uses a given ingredient instantly — no scrolling, no guessing.

  _Use this when an agent needs to suggest meals from available pantry items without making multiple API calls._

  ```bash
  anylist-pp-cli recipes search --query chicken --ingredient --agent
  ```
- **`recipes filter`** — Filter your entire recipe library by prep time, rating, serving count, and collection simultaneously.

  _Use this when an agent needs to find recipes that fit a time or quality constraint for meal planning._

  ```bash
  anylist-pp-cli recipes filter --max-prep 30 --min-rating 4 --collection Weeknight --agent
  ```
- **`lists by-store`** — Split a shopping list into per-store groups sorted by store aisle order — ready for multi-store shopping trips.

  _Use this when an agent needs to generate a structured shopping route across multiple stores._

  ```bash
  anylist-pp-cli lists by-store --name Groceries --agent
  ```
- **`recipes missing`** — See exactly which ingredients you still need to buy before adding a recipe — skip what's already on your list.

  _Use this before adding a recipe to a list to avoid redundant items and show users only the net-new ingredients they need._

  ```bash
  anylist-pp-cli recipes missing --recipe "Pasta Bake" --list Groceries --agent
  ```
- **`meal summary`** — Render a Mon–Sun meal plan grid with Breakfast/Lunch/Dinner labels — pasteable into messages or scripts.

  _Use this when an agent needs to present the week's meal plan in a human-readable format for sharing or review._

  ```bash
  anylist-pp-cli meal summary --week | pbcopy
  ```
- **`items search`** — Find any item across all your shopping lists at once — shows which list it's on and whether it's checked.

  _Use this when an agent needs to locate an item without knowing which list it was added to._

  ```bash
  anylist-pp-cli items search --query "almond milk" --agent
  ```

### Agent-native plumbing

- **`meal add-to-list`** — Automatically build this week's shopping list from your meal plan — idempotent and safe to run on a schedule.

  _Use this in a cron job or agent workflow to pre-populate the shopping list before a weekly grocery trip._

  ```bash
  anylist-pp-cli meal add-to-list --week --list Groceries --dry-run
  ```
- **`recipes add-to-list`** — Add a recipe's ingredients to your list while avoiding duplicate unchecked items already on the target list.

  _Use this when adding recipes to a list without creating duplicate unchecked line items._

  ```bash
  anylist-pp-cli recipes add-to-list --recipe "Pasta Bake" --list Groceries --scale 4 --merge
  ```
- **`lists reset`** — Clear all checked items from a list in one command — idempotent and safe for cron to run after every shopping trip.

  _Use this in a post-trip automation to reset the list for the next week without manually unchecking each item._

  ```bash
  anylist-pp-cli lists reset --name Groceries --keep-unchecked
  ```
- **`sync status`** — Report how fresh your local cache is per entity type, with exit code 1 if any data is stale.

  _Use this as a cron preflight check to ensure agent operations run against up-to-date local data._

  ```bash
  anylist-pp-cli sync status --stale-after 24h || anylist-pp-cli sync
  ```

## Command Reference

**categories** — View item categories

- `anylist-pp-cli categories` — List all item categories

**collections** — Manage recipe collections

- `anylist-pp-cli collections add` — Add a recipe to a collection
- `anylist-pp-cli collections create` — Create a new recipe collection
- `anylist-pp-cli collections delete` — Delete a recipe collection
- `anylist-pp-cli collections list` — List all recipe collections
- `anylist-pp-cli collections remove` — Remove a recipe from a collection

**favorites** — View favorite items

- `anylist-pp-cli favorites` — List favorite items across all lists

**folders** — Organize shopping lists into folders

- `anylist-pp-cli folders create` — Create a new list folder
- `anylist-pp-cli folders delete` — Delete a list folder
- `anylist-pp-cli folders list` — List all list folders

**items** — Manage items within a shopping list

- `anylist-pp-cli items add` — Add an item to a shopping list
- `anylist-pp-cli items check` — Mark one or more items as checked (bought)
- `anylist-pp-cli items list` — List items in a shopping list
- `anylist-pp-cli items recent` — Show recently added items across all lists
- `anylist-pp-cli items remove` — Remove an item from a shopping list
- `anylist-pp-cli items search` — Search for items by name across all shopping lists
- `anylist-pp-cli items uncheck` — Mark one or more items as unchecked
- `anylist-pp-cli items update` — Update an existing item's quantity or notes

**lists** — Manage shopping lists

- `anylist-pp-cli lists by-store` — Display a shopping list grouped by store with aisle ordering
- `anylist-pp-cli lists create` — Create a new shopping list
- `anylist-pp-cli lists delete` — Delete a shopping list
- `anylist-pp-cli lists list` — List all shopping lists
- `anylist-pp-cli lists reset` — Clear all checked items from a list to prepare for the next shopping trip
- `anylist-pp-cli lists settings` — View or update settings for a shopping list

**meal** — Manage the meal planning calendar

- `anylist-pp-cli meal add` — Add an event to the meal planning calendar
- `anylist-pp-cli meal add-to-list` — Add all recipe ingredients from the meal plan to a shopping list
- `anylist-pp-cli meal delete` — Delete a meal plan event
- `anylist-pp-cli meal labels` — List meal plan labels (Breakfast, Lunch, Dinner, Snack, etc.)
- `anylist-pp-cli meal show` — Show meal plan events for a date range (defaults to current week)
- `anylist-pp-cli meal summary` — Display the meal plan as a Mon–Sun grid with Breakfast/Lunch/Dinner labels

**recipes** — Manage recipes — import, organize, and add to shopping lists

- `anylist-pp-cl