Agent skill · software engineering · mvanhorn

pp-instacart

Printing Press CLI for Instacart. Natural-language Instacart CLI that talks directly to the web GraphQL API. Add items to your cart, search products, and manage carts across retailers without browser automation. Also caches your purchase history locally so 'add' resolves items you have bought before instead of guessing from live search. Trigger phrases: 'install instacart', 'use instacart', 'run instacart', 'add X to my Safeway cart', 'what did I buy last time', 'order the usual', 'add my regulars to Costco', 'backfill my instacart history', 'sync my instacart orders', 'download my order history', 'save my instacart history locally'.

Why this skill is useful

Adds a fully functional CLI for Instacart that allows natural language commands to interact with the GraphQL API, including caching and history management features.

What it needs

Requires instacart-pp-cli installed locally. About 10k tokens when loaded. Last updated 2026-08-06. 1,890 stars on the source repository.

What this skill does

Instacart - Printing Press CLI Prerequisites: Install the CLI This skill drives the instacart-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: 2. Verify: instacart-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.6 or newer): 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 Reach for this when a user wants: Add a product to an Instacart cart by natural language ("add lemon sorbet to QFC") Add something they have bought before ("add my usual milk to Safeway") Show, search, or compare their active carts across retailers List or search their own Instacart order history Run an Instacart flow from a script, cron job, or agent loop Do not reach for this if the user wants to actually check out. This CLI adds items to your cart; you still complete checkout in the Instacart app or web UI. Unique Capabilities History-first add add checks your local purchase history FIRST and, when a confident match exists at the target retailer, skips the three-call live GraphQL chain entirely. Drops the cost of "add the lemon sorbet pops I usually get" from ~1.2s to ~200ms AND makes it resolve to the right SKU (the one you actually buy) instead of whatever live search ranks highest today. Confidence rules: FTS5 match in your local purchaseditems at that retailer Purchased within the last 365 days Was in stock on the last purchase Falls through to today's live-search behavior when any condition fails. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills mvanhorn/instacart

View the source on GitHub

Browse the @skills marketplace