Bring! Shopping Lists

Bring Shopping List Integration

Interact with Bring! shopping lists to manage groceries and shopping items.

Prerequisites

The bring-shopping npm package must be installed:

npm install -g bring-shopping

Initial Setup

Before first use, configure Bring credentials:

./bring configure  

Credentials are stored in ~/.openclaw/bring/config.json.

Common Operations

List All Shopping Lists

Get all available shopping lists with their UUIDs:

./bring lists

Output includes list names, UUIDs, and themes.

Find a List by Name

Search for a list by partial name match:

./bring findlist "Home"
./bring findlist "Groceries"

Returns matching lists with their UUIDs.

View List Items

Show all items in a shopping list:

./bring items 

Or use the default list (if set):

./bring items

Returns items to purchase and recently purchased items.

Add Items

Add an item to a shopping list:

./bring add  "" ""

Examples:

./bring add abc-123 "Latte" "2 litri"
./bring add abc-123 "Pane"

Tip: Use item names that match what you already use in the Bring app to ensure icons appear.

Remove Items

Remove an item from a shopping list (moves to recent list):

./bring remove  ""

Set Default List

Set a default list UUID to avoid passing it each time:

./bring setdefault 

After setting default, you can use ./bring items without specifying listUuid.

Manage List Languages

Set the language for a list (for reference):

./bring setlang  it-IT
./bring setlang  es-ES
./bring setlang  en-US

Get the configured language:

./bring getlang 

Supported locales: en-US, it-IT, es-ES, de-DE, fr-FR

Workflow Examples

Adding to a Named List

When user says "Add milk to the Home list":

1. Find the list:

   ./bring findlist "Home"
   

2. Check what language/names are used in that list:

   ./bring items 
   

3. Add using the appropriate name (match existing items):

   ./bring add  "Latte"  # If list uses Italian
   # or
   ./bring add  "Milk"   # If list uses English
   

Checking What's Needed

When user asks "What's on my shopping list?":

./bring items 

Or if default is set:

./bring items

Parse and present items in a readable format.

Marking Items as Purchased

When user says "Remove milk from the list":

./bring remove  "Latte"

Multilingual Families

For families using multiple languages:

1. Check existing items in each list to see what language is used 2. Use consistent naming - match the names already in the list 3. Set list language with setlang for reference 4. Learn from context - if a list has "Latte", "Pane", "Uova", it's Italian

The Bring app automatically shows icons when item names match its catalog. To ensure icons appear, use names that match what the Bring app recognizes for that language.

Technical Details

Notes

The bring-shopping npm package must be installed:

npm install -g bring-shopping