← Back to Skills Marketplace
joekravelli

Bring! Shoppinglist

by JoeKravelli · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
28
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install bring-app
Description
Manage Bring! shopping lists via CLI to add, remove, complete, and view items or lists using the Bring! API.
README (SKILL.md)

Bring! Shopping List Skill

Manage Bring! shopping lists using the bring-api Python package via a bundled CLI script.

Setup (one-time)

  1. Install the Python dependency:

    python3 -m pip install bring-api
    
  2. Configure credentials — set env vars BRING_EMAIL and BRING_PASSWORD, or create ~/.openclaw/credentials/bring.json:

    {
      "email": "[email protected]",
      "password": "your_password"
    }
    
  3. (Optional) Set a default list via env var BRING_LIST (matches list title, case-insensitive).

Usage

All commands use the bundled script scripts/bring.py.

List all shopping lists

python3 scripts/bring.py list

Show items in a list

python3 scripts/bring.py items
python3 scripts/bring.py items --list "Einkauf"

Add an item

python3 scripts/bring.py add "Milch"
python3 scripts/bring.py add "Milch" --spec "fettarm"
python3 scripts/bring.py add "Zitronen" --list "Party"

Remove an item

python3 scripts/bring.py remove "Milch"
python3 scripts/bring.py remove "Milch" --list "Einkauf"

Complete (check off) an item

python3 scripts/bring.py complete "Milch"
python3 scripts/bring.py complete "Milch" --list "Einkauf"

Common Patterns

  • When the user says "add X to shopping list", extract the item name and optional spec, then call add.
  • When the user says "remove X from shopping list", call remove.
  • When the user says "check off X" or "done with X", call complete.
  • When the user says "show shopping list" or "what's on the list", call items.
  • If the user has multiple lists, use --list "Name" to target the right one.
  • If unsure which list, call list first and ask the user to confirm.

Troubleshooting

  • Authentication failed: Check email/password in ~/.bring.json or env vars. Bring! uses the email from the app account settings.
  • List not found: List names are case-insensitive but must match exactly. Use list to see available names.
  • Item not found: Item matching is case-insensitive. If duplicates exist, the first match is used.
  • ModuleNotFoundError: Run python3 -m pip install bring-api.

API Reference

Based on miaucl/bring-api (unofficial Bring! API, MIT license).

The CLI wraps these core API methods:

  • load_lists() → all shopping lists
  • get_list(listUuid) → items in one list
  • batch_update_list(listUuid, item, ADD) → add item
  • batch_update_list(listUuid, item, REMOVE) → remove item
  • batch_update_list(listUuid, item, COMPLETE) → check off item

License

This skill uses the MIT-licensed bring-api package. Bring! trademarks belong to Bring! Labs AG. This is not affiliated with or endorsed by Bring! Labs AG.

Usage Guidance
This appears safe to review as a normal Bring! shopping-list integration, not as malware. Before installing, verify the dependency, correct the script path if needed, store credentials carefully, and make sure the agent confirms the target list before changing items.
Capability Analysis
Type: OpenClaw Skill Name: bring-app Version: 1.0.0 The skill provides a legitimate CLI interface for managing Bring! shopping lists using the 'bring-api' library. It handles authentication via environment variables or a local configuration file (~/.openclaw/credentials/bring.json) and performs standard list operations (add, remove, complete, list) without any evidence of data exfiltration, malicious execution, or prompt injection.
Capability Tags
cryptocan-make-purchases
Capability Assessment
Purpose & Capability
The bundled code is coherent with the stated purpose: it lists, adds, removes, and completes Bring! shopping-list items. These are account mutations, so user intent and list selection matter.
Instruction Scope
The SKILL.md tells the agent to ask for confirmation if the target list is unclear, but the script itself defaults to the first Bring! list when no list or BRING_LIST value is supplied.
Install Mechanism
There is no install spec, while SKILL.md asks the user to run an unpinned `pip install bring-api`. SKILL.md also references `scripts/bring.py`, but the manifest provides `bring.py` at the package root.
Credentials
Bring! email/password use is expected for this integration, but registry metadata declares no required env vars or primary credential even though the skill and code require credentials to function.
Persistence & Privilege
The script does not create background processes or hidden persistence, but it supports a persistent local credential file at `~/.openclaw/credentials/bring.json`.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install bring-app
  3. After installation, invoke the skill by name or use /bring-app
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release: manage Bring! shopping lists via CLI using the bring-api Python package. - Supports adding, removing, completing, and listing items on any Bring! shopping list. - Easy authentication setup via environment variables or credentials file. - Includes commands for listing all shopping lists and specifying target lists by name. - Troubleshooting tips and full usage examples provided in documentation.
Metadata
Slug bring-app
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Bring! Shoppinglist?

Manage Bring! shopping lists via CLI to add, remove, complete, and view items or lists using the Bring! API. It is an AI Agent Skill for Claude Code / OpenClaw, with 28 downloads so far.

How do I install Bring! Shoppinglist?

Run "/install bring-app" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Bring! Shoppinglist free?

Yes, Bring! Shoppinglist is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Bring! Shoppinglist support?

Bring! Shoppinglist is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Bring! Shoppinglist?

It is built and maintained by JoeKravelli (@joekravelli); the current version is v1.0.0.

💬 Comments