bring-list

name

bring-list

description

Manage Bring! shopping lists (Einkaufsliste / grocery list) — add, remove, check off items, batch ops, default list support. Use when: user wants to set up Bring!, add items to shopping list, check what's on the list, or complete/remove items. Full guided setup in Telegram: agent handles login, list selection and config entirely in chat. Privacy-first: credentials via chat or private terminal input — your choice, never repeated. Terminal optional.

Bring! Shopping Lists

Manage Bring! shopping lists via the unofficial REST API. Requires curl and jq.

Agent Setup Guide

When a user asks you to set up or use Bring for the first time, follow these steps:

Step 1: Check if already configured

Run scripts/bring.sh lists first. If it works, setup is already done — skip to usage.

Step 2: Set up credentials

Bring! requires an email + password. If the user doesn't have an account yet, they can create one for free at getbring.com or in the Bring! app.

If they signed up via Google/Apple: They need to set a direct password first in the Bring! app (Settings → Account → Change Password) before the API works.

Ask the user how they'd like to provide their credentials:

"I need your Bring! email and password. You can either share them here in chat (I'll write them to a config file and never mention them again), or if you prefer to keep them out of the chat entirely, I can give you a terminal command to enter them privately. Which do you prefer?"

Option A — via chat (convenient): User shares email + password in chat. Write them directly to the config file using jq for safe JSON encoding (prevents injection via special characters) and do not echo them back:

mkdir -p ~/.config/bring
jq -n --arg e "USER_EMAIL" --arg p   > ~/.config/bring/credentials.json
 600 ~/.config/bring/credentials.json