kroger-cli-reference

---

name: Kroger CLI Reference description: Complete reference guide for using the Kroger CLI to search products, manage your cart, and automate grocery shopping at King Sooppers. Use this when you need to understand Kroger CLI commands, syntax, best practices for product selection, or troubleshoot Kroger operations.

Instructions

This skill provides comprehensive documentation for the Kroger CLI tool, which enables command-line automation of grocery shopping at King Sooppers (a Kroger store).

Use this skill when you need to:

• Understand how to use Kroger CLI commands
• Reference product search and cart management syntax
• Learn best practices for product selection
• Troubleshoot authentication or store issues
• Get examples of common operations

Overview

The Kroger CLI is a command-line tool for interacting with King Sooppers for automated shopping. It provides authentication, product search, and cart management capabilities.

Getting Started

Prerequisites

• The kroger command is available in $PATH and executable directly
• Kroger account with API authentication configured

Authentication & Sessions

Copykroger auth          # Check current API authentication status
kroger login         # Login to your Kroger account (use if auth fails)
kroger logout        # Logout from your account

Important Notes:

• Assume kroger auth is already valid before starting operations
• If authentication fails, run kroger login and wait for the response
• Authentication persists across sessions

Store Management

Available Commands

Copykroger store show     # Show currently selected store
kroger store set [ID] # Set your default store
kroger stores [ZIP]   # Search for stores by ZIP code

Assumptions:

• The store is already set; no need to reconfigure unless switching locations
• All operations default to the currently set store

Product Operations

Search & Discovery

Copykroger products "search term"     # Search for products by name/type
kroger product [ID/UPC]           # Get detailed info on a specific product

Examples:

Copykroger products "organic milk"
kroger products "chicken breast"
kroger product 0001111041700      # Get details for a specific UPC

Product Selection Guidelines

When searching for products, consider:

1. Brand Preferences

   • Follow explicit preferences when available

2. Default Selection Strategy

   • Prefer midrange brands on sale when no specific preference exists
   • Look for good value relative to quality

3. Quantity & Size Matching

   • Carefully match product quantity and size to the meal plan
   • Consider expected usage patterns for the week
   • Account for storage capacity and product shelf life

Cart Operations

Add to Cart

Copykroger cart add [UPC]              # Add item to cart (single unit)
kroger cart add [UPC] -q 2         # Add item with specific quantity

Examples:

Copykroger cart add 0001111041700
kroger cart add 0001111041700 -q 2

Requirements:

• Cart operations require valid login (kroger auth must pass)
• Assume cart starts empty (API doesn't allow checking existing items)

Tips & Best Practices

1. Search Thoroughly - Try multiple search terms if needed to find alternatives
2. Check Details - Use kroger product [UPC] to verify prices, sizes, and ratings before adding
3. Batch Operations - Add multiple items in sequence for efficiency
4. Quantity Planning - Use -q flag to add multiple units of the same product in one command
5. Sales & Deals - Look for sale prices when no brand preference is specified

Troubleshooting

• Auth Failed: Run kroger login and complete the login flow
• Product Not Found: Try alternative search terms or check spelling
• Store Issues: Verify store is set with kroger store show

More Help

Copykroger [command] --help    # Get detailed help for any command