willys-cli

Search Willys products, browse categories, and manage cart via terminal.

4|4|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/ErikHellman/willys-agent --skill willys-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: willys-cli
Source: https://github.com/ErikHellman/willys-agent/tree/main
Command: npx skills add https://github.com/ErikHellman/willys-agent --skill willys-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you find groceries and update your Willys shopping cart from the terminal instead of clicking through menus.

Core Features & Use Cases

  • Product search: Find items by query and review detailed product info (including codes) so you can choose the right product.
  • Category browsing: Explore the Willys category tree and browse items within a chosen category path.
  • Cart management: Add, remove, and clear items, with the updated cart shown after changes; supports bulk actions via a CSV import.

Quick Start

Install the skill into your project by running the willys-cli --install-skills command, then use it to search for groceries and add selected product codes to your cart.

Frequently Asked Questions about willys-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate grocery shopping cart management from the terminal?

Automate grocery shopping cart management by using a CLI tool to search for products, add items, and clear your cart via terminal commands. It authenticates with your Willys credentials and executes deterministic cart mutations without browser clicks.

Can I batch add multiple groceries to my shopping cart using a CSV file?

Yes, you can batch add groceries using a CSV file import. The CLI tool reads the CSV and processes bulk cart mutations deterministically, updating your Willys cart state with all specified items in a single operation.

How do I browse grocery categories when I don't have a specific product name?

Browse grocery categories by exploring the Willys category tree through the CLI. You can navigate category paths and list items within a chosen category, making it easy to discover products when your preferences are vague.

What credentials do I need to authenticate CLI automation for Willys grocery search?

You need your WILLYS_USERNAME and WILLYS_PASSWORD credentials to authenticate CLI automation for Willys grocery search. You can set these as environment variables or pass them directly using the -u and -p command flags.

Does terminal-based grocery search show detailed product information like product codes?

Yes, terminal-based grocery search displays detailed product information including product codes. After running a query search, the CLI returns product details so you can identify the correct items before adding them to your shopping cart.

What are the limitations of using CLI automation for grocery cart management?

CLI automation for grocery cart management is limited to Willys.se and requires valid account credentials. It relies on deterministic Bash commands, meaning it does not handle dynamic browser interactions or real-time price negotiations during the cart mutation process.