Coding

Bring

View, add, and remove Bring shopping-list items from a locale-aware CLI.

What it does

View Bring shopping lists, inspect current and recently bought items, and add or remove entries from the CLI. It can target a default list or UUID, prefers locale-aware smartadd for catalog icons, and falls back to raw add on a catalog miss. Removal moves an exact, case-sensitive item name to recent rather than deleting it.

When to use it

  • Adding groceries with catalog icons
  • Reviewing items to buy and recently bought
  • Managing multiple lists by name or UUID
  • Moving purchased items to recent

The skill document

Bring Shopping List Integration

Invocation

The CLI lives at scripts/bring-cli.js. Always prefix with NODE_PATH=$(npm root -g):

NODE_PATH=$(npm root -g) node ~/.openclaw/workspace/skills/bring/scripts/bring-cli.js  [args]

Prerequisites

npm install -g bring-shopping

Setup

NODE_PATH=$(npm root -g) node ~/.openclaw/workspace/skills/bring/scripts/bring-cli.js configure  

Config stored at ~/.openclaw/bring/config.json. Tokens cached at ~/.openclaw/bring/token.json (7-day expiry).

Commands

CommandArgsNotes
configure One-time setup
renewForce re-login if token expired
listsAll lists with UUIDs
findlist``Partial name match
items[listUuid]Default list if omitted
add [note]Raw add, no catalog lookup
smartadd [locale] [note]Preferred: catalog-aware, gets icons
remove Moves to recent
setdefault``Avoid passing UUID every time
detectlang``Auto-detect list language
setlang Cache language preference
getlang``Cached or auto-detected

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

Workflow

Adding items (prefer smartadd)

  1. If user doesn't specify a list, use default (check items without UUID first).
  2. Use smartadd with the list's locale for icon support. Fall back to add if catalog miss.
  3. Confirm what was added.

Viewing items

Run items (with listUuid or default). Present purchase items as "to buy" and recently as "recently bought".

Removing items

Run remove "". Item names are case-sensitive — match exactly from items output.

Gotchas

  • Item names are case-sensitive — copy exact names from items output.
  • remove moves to recent, doesn't delete.
  • Token cache expires after 7 days; run renew if commands start failing with auth errors.
  • smartadd needs the right locale to find catalog matches.
  • Lists use mixed languages (e.g. "Home in Florence" has Italian, German, English items). Detect per-list.

Questions people ask

What setup is required before managing a Bring list?
Install the global bring-shopping package, then run the configure command once. Configuration is stored in ~/.openclaw/bring/config.json, while the cached token expires after seven days and can be refreshed with renew.
How does adding an item with smartadd differ from add?
smartadd checks the catalog using the list locale so matching items can receive icons. If no catalog match is found, the documented workflow falls back to the raw add command.
Does removing an item delete it permanently?
No. remove moves the item to the recently bought section, and its name must match the case-sensitive output from items exactly.

Related skills

Read and manage Google Merchant Center resources through v1 APIs with managed OAuth and approval-gated writes.

231 installs5 stars

Manage Instagram profiles, posts, media publishing, and comments through the Instagram Graph API.

86 installs2 stars

Organize personal projects as scoped local notes, concrete tasks, phases, reviews, and archives.

82 installs5 stars

Manage beehiiv publications, subscribers, fields, segments, tiers, and automations through a managed OAuth API.

95 installs6 stars

Get action-focused reminders for known commitments at a useful lead time, with timing adapted from your feedback.

141 installs3 stars

Search products, prepare confirmed checkouts, and manage tracking, returns, and reorders.

79 installs128 stars