← Back to Skills Marketplace
Bring Add
by
darkdevelopers
· GitHub ↗
· v1.0.0
1950
Downloads
1
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install bring-add
Description
Use when user wants to add items to Bring! shopping lists. For adding single items, batch items, or items from stdin/files. Supports dry-run preview and JSON output.
README (SKILL.md)
Bring! Add Items CLI
Overview
CLI for adding items to Bring! shopping lists. Supports quick single-item mode, batch mode, stdin/pipe input, and interactive mode.
When to Use
Use this skill when:
- User wants to add items to a Bring! shopping list
- Adding single item with optional specification (e.g., "Milk 1L")
- Adding multiple items at once (batch mode)
- Piping items from a file or other command
- Need to preview additions with dry-run
- Need JSON output for scripting
Don't use when:
- User wants to browse recipes (use bring-recipes instead)
- User wants to remove items from a list
- User wants to view current list contents
Quick Reference
| Command | Purpose |
|---|---|
bring-add "Item" "spec" |
Add single item with specification |
bring-add --batch "A, B 1L, C" |
Add multiple comma-separated items |
bring-add - |
Read items from stdin |
bring-add |
Interactive mode (TTY only) |
bring-add lists |
Show available shopping lists |
bring-add --dry-run ... |
Preview without modifying |
Environment variables:
export BRING_EMAIL="[email protected]"
export BRING_PASSWORD="yourpassword"
export BRING_DEFAULT_LIST="Shopping" # optional
Installation
cd skills/bring-add
npm install
Common Workflows
Add a single item:
node index.js "Tomatoes" "500g"
node index.js "Milk"
Add to specific list:
node index.js --list "Party" "Chips" "3 bags"
Batch add multiple items:
node index.js --batch "Tomatoes 500g, Onions, Cheese 200g"
Pipe from file:
cat shopping-list.txt | node index.js -
echo -e "Milk 1L\
Bread\
Butter" | node index.js -
Preview before adding:
node index.js --dry-run --batch "Apples 1kg, Pears"
Get JSON output:
node index.js --json --batch "Milk, Bread" 2>/dev/null
List available lists:
node index.js lists
node index.js --json lists
Flags Reference
| Flag | Description |
|---|---|
-l, --list \x3Cname> |
Target list (name or UUID) |
-b, --batch \x3Citems> |
Comma-separated items |
-n, --dry-run |
Preview without modifying |
-q, --quiet |
Suppress non-error output |
-v, --verbose |
Show detailed progress |
--json |
Output JSON to stdout |
--no-color |
Disable colored output |
--no-input |
Never prompt; fail if input required |
Input Format
Items follow the pattern: ItemName [Specification]
| Input | Item | Spec |
|---|---|---|
Tomatoes 500g |
Tomatoes | 500g |
Oat milk 1L |
Oat milk | 1L |
Red onions 3 |
Red onions | 3 |
Cheese |
Cheese | (empty) |
Rule: Last word becomes specification if it contains a number or unit (g, kg, L, ml, Stück, pck).
Exit Codes
| Code | Meaning |
|---|---|
0 |
Success |
1 |
Generic failure (API error, network) |
2 |
Invalid usage (bad args, missing input) |
3 |
Authentication failed |
4 |
List not found |
130 |
Interrupted (Ctrl-C) |
Common Mistakes
Forgetting environment variables:
Set BRING_EMAIL and BRING_PASSWORD before running.
Wrong list name:
Use bring-add lists to see available lists and their exact names.
Specification parsing: The last word is treated as specification only if it looks like a quantity. "Red onions" stays as one item, but "Red onions 3" splits into item "Red onions" with spec "3".
Interactive mode in scripts:
Use --no-input flag in scripts to fail explicitly rather than hang waiting for input.
Implementation Notes
- Uses
node-bring-apiwithbatchUpdateList()API - Requires Node.js 18.0.0+
- Outputs data to stdout, progress/errors to stderr
- JSON mode available for automation
- Interactive mode only when stdin is a TTY
Usage Guidance
This skill likely needs your Bring! account credentials and npm dependencies to run. Before installing or running it: 1) Inspect index.js, package.json and package-lock.json for network calls, unexpected modules, or code that reads unrelated files or exfiltrates data. 2) Verify the authentication method — prefer tokens over storing plaintext passwords in env vars if possible. 3) Run npm install and the code in an isolated environment (container or VM) if you must test it. 4) Ask the publisher for a homepage or source repo to validate origin; the registry metadata lacking declared env vars is a transparency gap. If you cannot review the code and dependencies, avoid providing account credentials to this skill.
Capability Analysis
Type: OpenClaw Skill
Name: bring-add
Version: 1.0.0
The skill 'bring-add' is a CLI tool designed to add items to Bring! shopping lists. It explicitly requires `BRING_EMAIL` and `BRING_PASSWORD` environment variables for authentication with the Bring! API, which is clearly documented in `SKILL.md` and `README.md` and handled in `index.js`. The code uses standard Node.js I/O and the `bring-shopping` library to perform its stated function. There is no evidence of data exfiltration beyond necessary API credentials, malicious execution (e.g., `eval`, `exec` of untrusted input), persistence mechanisms, or prompt injection attempts against the AI agent. The dependencies are standard for a CLI application, and the overall behavior is strictly aligned with its described purpose.
Capability Assessment
Purpose & Capability
The SKILL.md and code indicate this interacts with the Bring! API (auth + batch updates), which legitimately requires credentials and Node runtime. However, the registry metadata lists no required environment variables or primary credential despite the README instructing users to export BRING_EMAIL and BRING_PASSWORD. That mismatch is unexpected and reduces transparency.
Instruction Scope
The runtime instructions tell the agent/user to provide email/password env vars, run node index.js, pipe stdin, and perform API calls (batchUpdateList). Those steps are consistent with the described purpose, but the instructions reference sensitive credentials that are not declared elsewhere. No other out-of-scope file or system access is requested in SKILL.md.
Install Mechanism
There is no formal install spec in the registry, but the SKILL.md instructs running npm install and the package files (package.json, package-lock.json, index.js) are included. The lack of an install specification in metadata means dependency installation will be manual or implicit — you should inspect package.json/package-lock.json and index.js for suspicious dependencies or post-install behavior before running npm install.
Credentials
SKILL.md requires BRING_EMAIL and BRING_PASSWORD to authenticate to Bring!. Those are sensitive credentials but are reasonable for this functionality — however, the skill metadata does not declare any required env vars or a primary credential, making the request for credentials non-transparent and disproportionate to what the registry advertises.
Persistence & Privilege
No special privileges are requested in registry flags: always, disableModelInvocation, and other persistence flags are not set. The skill is not declared as always-on or model-invocable by default beyond normal behavior.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install bring-add - After installation, invoke the skill by name or use
/bring-add - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
bring-add 1.0.0 initial release
- CLI tool to add items to Bring! shopping lists.
- Supports single item, batch, stdin/file, and interactive input modes.
- Includes dry-run preview and JSON output for scripting.
- Provides commands to list available shopping lists.
- Flexible item parsing with specification support (e.g., "Milk 1L").
Metadata
Frequently Asked Questions
What is Bring Add?
Use when user wants to add items to Bring! shopping lists. For adding single items, batch items, or items from stdin/files. Supports dry-run preview and JSON output. It is an AI Agent Skill for Claude Code / OpenClaw, with 1950 downloads so far.
How do I install Bring Add?
Run "/install bring-add" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Bring Add free?
Yes, Bring Add is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Bring Add support?
Bring Add is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Bring Add?
It is built and maintained by darkdevelopers (@darkdevelopers); the current version is v1.0.0.
More Skills