bring-add

# 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:**
```bash
export BRING_EMAIL="your@email.com"
export BRING_PASSWORD="yourpassword"
export BRING_DEFAULT_LIST="Shopping"  # optional
```

## Installation

```bash
cd skills/bring-add
npm install
```

## Common Workflows

**Add a single item:**
```bash
node index.js "Tomatoes" "500g"
node index.js "Milk"
```

**Add to specific list:**
```bash
node index.js --list "Party" "Chips" "3 bags"
```

**Batch add multiple items:**
```bash
node index.js --batch "Tomatoes 500g, Onions, Cheese 200g"
```

**Pipe from file:**
```bash
cat shopping-list.txt | node index.js -
echo -e "Milk 1L\nBread\nButter" | node index.js -
```

**Preview before adding:**
```bash
node index.js --dry-run --batch "Apples 1kg, Pears"
```

**Get JSON output:**
```bash
node index.js --json --batch "Milk, Bread" 2>/dev/null
```

**List available lists:**
```bash
node index.js lists
node index.js --json lists
```

## Flags Reference

| Fl...

# bring-add

Add items to Bring! shopping lists from the command line.

## Installation

```bash
cd /path/to/node-bring-api/skills/bring-add
npm install
```

## Quick Start

```bash
# Set credentials
export BRING_EMAIL="your@email.com"
export BRING_PASSWORD="yourpassword"
export BRING_DEFAULT_LIST="Shopping"  # optional

# Add a single item
node index.js "Tomatoes" "500g"
```

## Usage

```
bring-add [global flags] [item] [spec]
bring-add [global flags] <subcommand>
```

### Quick Mode (single item)

```bash
node index.js "Tomatoes" "500g"
node index.js "Milk"
node index.js --list "Party" "Chips" "3 bags"
```

### Batch Mode (multiple items)

```bash
node index.js --batch "Tomatoes 500g, Onions, Cheese 200g"
```

### Stdin Mode

```bash
echo -e "Milk 1L\nBread\nButter" | node index.js -
cat shopping-list.txt | node index.js -
```

### Interactive Mode

```bash
node index.js
```

When stdin is a TTY and no arguments are provided, enters interactive mode:

```
Adding to list: Shopping

Enter items (empty line to finish):
> Tomatoes 500g
> Onions
> Cheese 200g
>

Added 3 items to "Shopping"
```

### List Shopping Lists

```bash
node index.js lists
node index.js -v lists          # show UUIDs
node index.js --json lists      # JSON output
```

## Global Flags

| Flag | Description |
|------|-------------|
| `-h, --help` | Show help and exit |
| `-V, --version` | Print version and exit |
| `-l, --list <name>` | Target list (name or UUID) |
| `-b, --batch <items>` | 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 colors |
| `--no-input` | Never prompt; fail if input required |

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `BRING_EMAIL` | Yes | Bring! account email |
| `BRING_PASSWORD` | Yes | Bring! account password |
| `BRING_DEFAULT_LIST`...