bring

# Bring Shopping List Integration

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

## Prerequisites

The `bring-shopping` npm package must be installed:

```bash
npm install -g bring-shopping
```

## Initial Setup

Before first use, configure Bring credentials:

```bash
./bring configure <email> <password>
```

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

## Common Operations

### List All Shopping Lists

Get all available shopping lists with their UUIDs:

```bash
./bring lists
```

Output includes list names, UUIDs, and themes.

### Find a List by Name

Search for a list by partial name match:

```bash
./bring findlist "Home"
./bring findlist "Groceries"
```

Returns matching lists with their UUIDs.

### View List Items

Show all items in a shopping list:

```bash
./bring items <listUuid>
```

Or use the default list (if set):

```bash
./bring items
```

Returns items to purchase and recently purchased items.

### Add Items

Add an item to a shopping list:

```bash
./bring add <listUuid> "<item-name>" "<optional-note>"
```

Examples:
```bash
./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):

```bash
./bring remove <listUuid> "<item-name>"
```

### Set Default List

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

```bash
./bring setdefault <listUuid>
```

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

### Manage List Languages

Set the language for a list (for reference):

```bash
./bring setlang <listUuid> it-IT
./bring setlang <listUuid> es-ES
./bring setlang <listUuid> en-US
```

Get the configured language:

```bash
./bring getlang <listUuid>
```

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

## Workflow Examples

### Adding to a Named List

When user says "Add milk t...