CLI for Bring! Shopping Lists - manage lists, add recipes, and more.
Build locally:
go build -o brings ./cmd/bringsOr install into your $GOBIN:
go install ./cmd/bringsbrew tap benithors/tap
brew install brings-cliBrowser-based login uses Playwright. The CLI will try to install Playwright automatically if needed, but you can also pre-install:
go run github.com/playwright-community/playwright-go/cmd/playwright installLogin via browser (recommended - handles bot detection):
brings login --browserThis opens Chrome, you log in to Bring!, and the token is extracted automatically.
# Show all shopping lists
brings lists
# Show items to purchase
brings items
# Add item to list
brings add Milk --spec "2%"
# Remove item
brings remove Milk
# Mark as purchased
brings complete MilkBrowse and add recipe ingredients to your shopping list:
# List saved recipes
brings inspirations
# View recipe details
brings recipe <id>
# Add recipe ingredients to cart
brings add-recipe <id>Set default servings for recipe scaling:
# Set servings (scales all recipes)
brings config servings 4
# View current config
brings configAuthentication:
login --browser Open browser for login
login --token <token> Login with token directly
logout Clear saved credentials
status Show login status
Shopping List:
lists Show all shopping lists
items [--list <uuid>] Show items to purchase
add <item> [--spec ".."] Add item to list
remove <item> Remove item
complete <item> Mark as purchased
Recipes:
inspirations [filter] List saved recipes with IDs
recipe <id> Show recipe details
add-recipe <id> Add ingredients to shopping list
--servings <n> Scale for n servings
--all Include pantry items
Social:
users Show users sharing the list
notify <type> Send notification
activity Show recent activity
Settings:
account Show account info
config Show/set configuration
catalog [locale] Browse item catalog
For AI agents integrating with Bring!:
# 1. List recipes with IDs
brings inspirations
# 2. Add recipe to shopping list (scaled to config servings)
brings add-recipe <id>This project is not affiliated with Bring! Labs AG.
MIT