bring-recipes

# Bring! Recipe Browser CLI

## Overview

CLI for browsing Bring! recipe inspirations. **Browse-only tool** - the Bring! Inspirations API does not provide ingredient lists.

## When to Use

**Use this skill when:**
- User wants to discover Bring! recipes
- Browsing recipe inspirations
- Viewing recipe metadata (names, authors, types, images, links)
- Filtering recipes by tags (all, mine)
- Need JSON output of recipes for scripting

**Don't use when:**
- User wants to add ingredients to shopping list (API limitation)
- Managing shopping lists directly
- Need full recipe details with ingredients

## Quick Reference

| Command | Purpose |
|---------|---------|
| `bring-recipes list` | Browse recipe inspirations (default) |
| `bring-recipes filters` | Show available filter tags |
| `bring-recipes list --filter mine` | Show your personal recipes |
| `bring-recipes list --json` | JSON output for scripting |

**Environment variables:**
```bash
export BRING_EMAIL="your@email.com"
export BRING_PASSWORD="yourpassword"
```

## Installation

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

## Common Workflows

**Browse all recipes:**
```bash
node index.js list --limit 10
```

**Filter your recipes:**
```bash
node index.js list --filter mine
```

**Get JSON for scripting:**
```bash
node index.js list --json | jq -r '.[] | .content.name'
```

**Check available filters:**
```bash
node index.js filters
```

## Flags Reference

| Flag | Description |
|------|-------------|
| `-f, --filter <tags>` | Filter tags: all, mine |
| `--limit <n>` | Max recipes (default: 10) |
| `--json` | JSON output |
| `--no-color` | Disable colors |
| `-q, --quiet` | Minimal output |
| `-v, --verbose` | Debug output |

## API Limitations

⚠️ **Critical:** The Bring! `getInspirations()` API returns only metadata:
- ✅ Recipe names, authors, types
- ✅ Images, links, tags, like counts
- ❌ **Ingredient lists** (not provided)

This is a Bring! API limitation, not a CLI bug. The CLI is designed for **browsin...