Pp Anylist
Apps & Automationpp-anylistPp Anylist is an Agent Skill for apps & automation published in the mvanhorn/printing-press-library repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Every AnyList feature in your terminal — plus offline search, store routing, and cron-safe automations no mobile... Trigger phrases: `add to my grocery list`, `what recipes can I make with`, `build my shopping list from meal plan`, `check off items on anylist`, `use anylist`, `run anylist`.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/mvanhorn/printing-press-library/blob/HEAD/cli-skills/pp-anylist/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/pp-anylist, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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:
- Install via the Printing Press installer. It defaults binaries to
$HOME/.local/binon macOS/Linux and%LOCALAPPDATA%\Programs\PrintingPress\binon Windows:npx -y @mvanhorn/printing-press-library install anylist --cli-only - Verify:
anylist-pp-cli --version - Ensure the reported install directory is on
$PATHfor 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.5 or newer):
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 collectionanylist-pp-cli collections create— Create a new recipe collectionanylist-pp-cli collections delete— Delete a recipe collectionanylist-pp-cli collections list— List all recipe collectionsanylist-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 folderanylist-pp-cli folders delete— Delete a list folderanylist-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 listanylist-pp-cli items check— Mark one or more items as checked (bought)anylist-pp-cli items list— List items in a shopping listanylist-pp-cli items recent— Show recently added items across all listsanylist-pp-cli items remove— Remove an item from a shopping listanylist-pp-cli items search— Search for items by name across all shopping listsanylist-pp-cli items uncheck— Mark one or more items as uncheckedanylist-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 orderinganylist-pp-cli lists create— Create a new shopping listanylist-pp-cli lists delete— Delete a shopping listanylist-pp-cli lists list— List all shopping listsanylist-pp-cli lists reset— Clear all checked items from a list to prepare for the next shopping tripanylist-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 calendaranylist-pp-cli meal add-to-list— Add all recipe ingredients from the meal plan to a shopping listanylist-pp-cli meal delete— Delete a meal plan eventanylist-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-cli recipes add-to-list— Add recipe ingredients to a shopping list, avoiding duplicate unchecked itemsanylist-pp-cli recipes batch-add— Add ingredients from multiple recipes to a list at onceanylist-pp-cli recipes create— Create a new recipeanylist-pp-cli recipes delete— Delete a recipeanylist-pp-cli recipes filter— Filter recipes by prep time, rating, servings, and collectionanylist-pp-cli recipes import— Import a recipe from a URLanylist-pp-cli recipes list— List all recipesanylist-pp-cli recipes missing— Show which recipe ingredients are not already on a shopping listanylist-pp-cli recipes scale— Scale a recipe's ingredient quantities to a target serving countanylist-pp-cli recipes search— Search recipes by name or ingredient (uses local SQLite cache)anylist-pp-cli recipes show— Show full recipe details including ingredients and preparation steps
starters — Manage starter list items (template items for new lists)
anylist-pp-cli starters— List starter list items
stores — View and manage stores and store filters
anylist-pp-cli stores— List all stores and store filters
Finding the right command
When you know what you want to do but not which command does it, ask the CLI directly:
anylist-pp-cli which "<capability in your own words>"
which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.
Recipes
Sunday meal-prep: build grocery list from this week's plan
anylist-pp-cli meal add-to-list --week --list Groceries --dry-run && anylist-pp-cli meal add-to-list --week --list Groceries
Preview then execute: adds this week's meal plan ingredients to the Groceries list idempotently.
Find quick weeknight recipes with available chicken
anylist-pp-cli recipes search --query chicken --ingredient --agent | anylist-pp-cli recipes filter --max-prep 30 --min-rating 4
Search by ingredient then filter by metadata — pure offline SQLite, no API calls.
Check what you still need before adding a recipe
anylist-pp-cli recipes missing --recipe "Thai Green Curry" --list Groceries --agent
Shows only the ingredients not already on your shopping list — prevents duplicates.
Get per-store shopping route as structured JSON
anylist-pp-cli lists by-store --name Groceries --agent --select name,storeName,category
Groups items by store with sort_index ordering; --select narrows the payload for agent context.
Post-trip cleanup + next-week reset via cron
anylist-pp-cli lists reset --name Groceries --keep-unchecked && anylist-pp-cli sync status --stale-after 12h || anylist-pp-cli sync
Remove checked items, keep unchecked, then ensure cache is fresh — safe to run in a cron job.
Auth Setup
AnyList uses email + password authentication returning a short-lived access_token and a refresh_token. The CLI stores these in ~/.config/anylist-pp-cli/config.toml and transparently refreshes on 401 responses. All requests require two additional headers: X-AnyLeaf-API-Version: 3 and a stable X-AnyLeaf-Client-Identifier (a 32-char hex UUID generated once per device and reused).
Run anylist-pp-cli doctor to verify setup.
Agent Mode
Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.
-
Pipeable — JSON on stdout, errors on stderr
-
Filterable —
--selectkeeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:anylist-pp-cli categories --agent --select id,name,status -
Previewable —
--dry-runshows the request without sending -
Non-interactive — never prompts, every input is a flag
-
Explicit retries — use
--idempotentonly when an already-existing create should count as success
Agent Feedback
When you (or the agent) notice something off about this CLI, record it:
anylist-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
anylist-pp-cli feedback --stdin < notes.txt
anylist-pp-cli feedback list --json --limit 10
Entries are stored locally at ~/.anylist-pp-cli/feedback.jsonl. They are never POSTed unless ANYLIST_FEEDBACK_ENDPOINT is set AND either --send is passed or ANYLIST_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.
Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
Output Delivery
Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
| Sink | Effect |
|---|---|
stdout | Default; write to stdout only |
file:<path> | Atomically write output to <path> (tmp + rename) |
webhook:<url> | POST the output body to the URL (application/json or application/x-ndjson when --compact) |
Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
Named Profiles
A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
anylist-pp-cli profile save briefing --json
anylist-pp-cli --profile briefing categories
anylist-pp-cli profile list --json
anylist-pp-cli profile show briefing
anylist-pp-cli profile delete briefing --yes
Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.
Exit Codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 2 | Usage error (wrong arguments) |
| 3 | Resource not found |
| 4 | Authentication required |
| 5 | API error (upstream issue) |
| 7 | Rate limited (wait and retry) |
| 10 | Config error |
Argument Parsing
Parse $ARGUMENTS:
- Empty,
help, or--help→ showanylist-pp-cli --helpoutput - Starts with
install→ ends withmcp→ MCP installation; otherwise → see Prerequisites above - Anything else → Direct Use (execute as CLI command with
--agent)
MCP Server Installation
Install the MCP binary from this CLI's published public-library entry or pre-built release, then register it:
claude mcp add anylist-pp-mcp -- anylist-pp-mcp
Verify: claude mcp list
Direct Use
- Check if installed:
which anylist-pp-cliIf not found, offer to install (see Prerequisites at the top of this skill). - Match the user query to the best command from the Unique Capabilities and Command Reference above.
- Execute with the
--agentflag:anylist-pp-cli <command> [subcommand] [args] --agent - If ambiguous, drill into subcommand help:
anylist-pp-cli <command> --help.