module-claude-consumer-agent

MageOS_ClaudeConsumerAgent is a shopping assistant module for Hyvä and Luma storefronts on Magento 2 and Mage-OS. It ports Anthropic's open-source shopping agent to a Magento module. The assistant searches the catalog, explains products, adds them to the cart, checks orders and answers policy questions from the store's own data. Replies stream from the Claude Messages API into a side panel on every page.

The module names no store. Every backend call goes through Api\StorefrontBackendInterface, so a store layer can replace or extend any part without a change to the base module. The customer gets a launcher button that opens a panel on the right, or a bottom sheet on a phone. The transcript survives page changes and reloads. The assistant is absent from the checkout steps and the order success page. Product cards show image, price, stock, a one-line reason and Add to cart. Configurable products list their sizes and colours first; the assistant never picks a variant on its own. Cart actions operate on the store's own quote: add, remove, change quantity, set custom options.

The assistant answers about the current page, provides order status for logged-in customers, policy answers quoted from CMS pages, and store facts such as gift wrapping or price match from the admin. It includes suggestion chips above the message box, an AI label, and a "Need a person" link. Requirements include PHP 8.1 to 8.5 and Magento 2.4 or Mage-OS 3.x with a Hyvä theme on Tailwind 4 or a theme based on Magento/blank or Magento/luma. An Anthropic API key with access to the configured model is required.