{"skill":{"slug":"kroger-grocery","displayName":"Kroger Grocery","summary":"Grocery ordering via Kroger-family stores (Kroger, Fred Meyer, Ralph's, Harris Teeter, King Soopers, Mariano's, QFC, Smith's, etc). Use when: (1) user asks t...","description":"---\nname: kroger-grocery\ndescription: \"Grocery ordering via Kroger-family stores (Kroger, Fred Meyer, Ralph's, Harris Teeter, King Soopers, Mariano's, QFC, Smith's, etc). Use when: (1) user asks to order groceries or add items to cart, (2) user wants to build a grocery list or meal plan with cart integration, (3) user says 'order the usual' or references a staples list, (4) user asks about product availability or prices at their local store. Requires kroget CLI and a Kroger Developer API app.\"\n---\n\n# Kroger Grocery Ordering\n\nOrder groceries via the Kroger API using the [kroget](https://github.com/VargasDevelopment/kroget) CLI. Works with all Kroger-family banners.\n\n## Supported Stores\n\nKroger, Fred Meyer, Ralph's, Harris Teeter, King Soopers, Mariano's, QFC, Smith's, Fry's, Dillons, Baker's, City Market, Food 4 Less, Foods Co, Jay C, Owen's, Pay Less, Pick 'n Save, Metro Market, Gerbes.\n\n## Setup\n\nSee `references/setup.md` for full first-time setup guide.\n\nQuick version:\n1. `pipx install kroget`\n2. Register app at developer.kroger.com → get client_id + client_secret\n3. `kroget setup --client-id ... --client-secret ...`\n4. `kroget auth login` → user authorizes in browser\n5. Look up store: `kroget products search \"test\" --location-id <zip>`\n\n## Core Commands\n\n### Search products\n```bash\nkroget products search \"QUERY\" --location-id STORE_ID --json\n```\n\n### Add to cart\n```bash\nkroget cart add --location-id STORE_ID --product-id UPC --quantity N --apply --yes\n```\n\n### Check auth\n```bash\nkroget doctor\n```\n\n## Workflow\n\n### Ad-Hoc Items\nUser says \"add milk and eggs to the cart\":\n1. Search each item: `kroget products search \"milk\" --location-id STORE_ID --json`\n2. Pick the best match (or present options if ambiguous)\n3. Add to cart: `kroget cart add --location-id STORE_ID --product-id UPC --quantity 1 --apply --yes`\n4. Confirm what was added with prices\n\n### Meal Planning\nUser asks for meal planning with grocery integration:\n1. Plan meals based on preferences and dietary restrictions\n2. Build ingredient list\n3. Search and add each item to cart\n4. Report total estimated cost\n5. Remind user to open store app to schedule pickup\n\n### Staples / \"Order the Usual\"\nFor repeat orders, maintain staples lists in a local file:\n1. First time: user provides their regular items\n2. Save to a staples file (JSON or markdown)\n3. On repeat: search and add all staples to cart\n4. Report any items out of stock or price changes\n\n## Important Safety Rules\n\n- **Never attempt checkout** — the API physically cannot do it, and that's a feature\n- **Always report prices** before or after adding to cart\n- **User must confirm pickup** in their store's app or website\n- **Cart add requires `--apply`** — without it, nothing happens\n- The API can **add** to cart but **cannot read** cart contents or **place orders**\n\n## Dietary Restrictions\n\nWhen the user has dietary restrictions, always vet items:\n- Check product descriptions for allergens\n- Search with restriction-specific terms (e.g., \"gluten free pasta\")\n- Flag items that might contain restricted ingredients\n- When in doubt, present options and let the user choose\n\n## Token Refresh\n\nKroger OAuth tokens expire. kroget handles refresh automatically. If the refresh token expires (extended inactivity), user needs to re-authorize:\n```bash\nkroget auth login\n```\nDetect auth failures and prompt for re-auth.\n\n## Notes\n\n- Product IDs are UPCs (e.g., `0001111018221`)\n- `--location-id` is required for product search and cart operations\n- Each store has unique inventory and pricing\n- Use `--json` flag for parseable output\n- kroget stores config at `~/.kroget/` (config.json, tokens.json)\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":183,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772013620069,"updatedAt":1778491636632},"latestVersion":{"version":"1.0.0","createdAt":1772013620069,"changelog":"Initial release: grocery ordering via Kroger-family stores with kroget CLI","license":null},"metadata":null,"owner":{"handle":"alfred-pennyworth-ai","userId":"s17060gb4aag1hvenwrv40r281885evm","displayName":"Alfred","image":"https://avatars.githubusercontent.com/u/262085742?v=4"},"moderation":null}