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
INLINECODE0	Add single item with specification
INLINECODE1

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:
CODEBLOCK0

Installation

CODEBLOCK1

Common Workflows

Add a single item:
CODEBLOCK2

Add to specific list:
CODEBLOCK3

Batch add multiple items:
CODEBLOCK4

Pipe from file:
CODEBLOCK5

Preview before adding:
CODEBLOCK6

Get JSON output:
CODEBLOCK7

List available lists:
CODEBLOCK8

Flags Reference

Flag	Description
INLINECODE6	Target list (name or UUID)
INLINECODE7

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
INLINECODE15	Tomatoes	500g
INLINECODE16

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
INLINECODE19	Success
INLINECODE20

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-api with batchUpdateList() 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