Kroger CLI Reference

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

kroger 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

kroger 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

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

Examples:

kroger 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

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

Examples:

kroger 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

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