bento --version

# Check authentication status
bento auth status

# Log out and remove stored credentials
bento auth logout

# Interactive setup
bento profile add staging

# Non-interactive (for scripting)
bento profile add production \
  --publishable-key "pk_live_..." \
  --secret-key "sk_live_..." \
  --site-uuid "your-site-uuid"

bento profile list

bento profile use staging

bento profile remove staging

# Skip confirmation
bento profile remove staging --yes

# Open Bento dashboard in your browser
bento dashboard

# Open for a specific profile
bento dashboard --profile staging

# Look up by email
bento subscribers search --email "john@example.com"

# Look up by UUID
bento subscribers search --uuid "abc-123-def"

# Filter by tag
bento subscribers search --email "john@example.com" --tag "vip"

# Filter by field value
bento subscribers search --email "john@example.com" --field plan=pro

# Preview what will be imported (dry run)
bento subscribers import ./contacts.csv --dry-run

# Preview with sample items
bento subscribers import ./contacts.csv --dry-run --sample 5

# Import with confirmation
bento subscribers import ./contacts.csv --confirm

# Limit to first N rows
bento subscribers import ./contacts.csv --limit 100 --confirm

email,first_name,last_name,company
john@example.com,John,Doe,Acme Corp
jane@example.com,Jane,Smith,Widget Co

# Create or update with tags and fields
bento subscribers upsert \
  --email "john@example.com" \
  --tags "customer,vip" \
  --fields '{"name": "John", "plan": "pro"}'

# Remove tags while adding others
bento subscribers upsert \
  --email "john@example.com" \
  --tags "active" \
  --remove-tags "trial"

# Add tags to a single subscriber
bento subscribers tag --email "john@example.com" --add "VIP,newsletter"

# Remove tags
bento subscribers tag --email "john@example.com" --remove "trial"

# Bulk tag from a file
bento subscribers tag --file users.csv --add "customer,active" --confirm

# Preview bulk tagging
bento subscribers tag --file users.csv --add "vip" --dry-run

# Set a single field (does NOT trigger automations)
bento subscribers field set --email "john@example.com" --key plan --value pro

# Remove a field
bento subscribers field remove --email "john@example.com" --key company

# Update multiple fields (TRIGGERS automations)
bento subscribers field update \
  --email "john@example.com" \
  --fields '{"name": "John", "plan": "pro"}'

# Single subscriber
bento subscribers subscribe --email "john@example.com"
bento subscribers unsubscribe --email "john@example.com"

# Bulk from file
bento subscribers subscribe --file reactivate.csv --confirm
bento subscribers unsubscribe --file suppression-list.csv --confirm

# Trigger automations on unsubscribe
bento subscribers unsubscribe --email "john@example.com" --trigger-automations

bento subscribers change-email --old "old@example.com" --new "new@example.com"

bento tags list

# Filter by name
bento tags list newsletter

bento tags create "webinar-attendees"
bento tags create "vip-customers"

bento tags delete "old-tag"

# Skip confirmation
bento tags delete "old-tag" --confirm

bento fields list

# Filter by name
bento fields list company

bento fields create "company_name"
bento fields create "plan_type"

bento events track --email "user@example.com" --event "completed_onboarding"

# With additional details
bento events track \
  --email "user@example.com" \
  --event "completed_onboarding" \
  --details '{"plan": "pro", "trial_days": 14}'

bento events purchase \
  --email "user@example.com" \
  --amount 4999 \
  --currency USD \
  --key "order_12345" \
  --cart '{"items": [{"product_sku": "SKU123", "product_name": "Widget", "quantity": 2}]}'

bento events import events.json

[
  {"email": "user@example.com", "type": "signed_up"},
  {"email": "user@example.com", "type": "completed_onboarding", "details": {"plan": "pro"}}
]

bento broadcasts list

# Paginate results
bento broadcasts list --page 2 --per-page 10

bento broadcasts create \
  --name "Spring Newsletter" \
  --subject "Big Announcement!" \
  --content "<h1>Hello!</h1>" \
  --type html \
  --from-name "Your Company" \
  --from-email "hello@yourcompany.com" \
  --include-tags "newsletter,active" \
  --exclude-tags "unsubscribed" \
  --batch-size 5000

bento sequences list

# With inline HTML
bento sequences create-email \
  --sequence-id "sequence_abc123" \
  --subject "Welcome to Day 2" \
  --html "<h1>Getting Started</h1><p>Here's what to do next...</p>" \
  --delay-interval days \
  --delay-count 1

# From an HTML file
bento sequences create-email \
  --sequence-id "sequence_abc123" \
  --subject "Your Weekly Tips" \
  --html-file ./emails/weekly-tips.html \
  --delay-interval days \
  --delay-count 7 \
  --inbox-snippet "This week's top tips"

# Update subject
bento sequences update-email --template-id 12345 --subject "Updated Subject"

# Update HTML from file
bento sequences update-email --template-id 12345 --html-file ./updated.html

bento emails send \
  --to "user@example.com" \
  --from "info@yourcompany.com" \
  --subject "Order Confirmation" \
  --html-body "<h1>Thanks for your order!</h1>" \
  --personalizations '{"order_id": "12345", "total": "$49.99"}'

bento emails send-batch --file batch-emails.json

[
  {
    "to": "user1@example.com",
    "from": "info@yourcompany.com",
    "subject": "Welcome!",
    "html_body": "<h1>Hello!</h1>"
  },
  {
    "to": "user2@example.com",
    "from": "info@yourcompany.com",
    "subject": "Welcome!",
    "html_body": "<h1>Hello!</h1>"
  }
]

bento templates get 12345

# Update subject
bento templates update 12345 --subject "New Subject Line"

# Update HTML
bento templates update 12345 --html "<h1>Updated Content</h1>"

bento workflows list

bento forms responses my_form_id

bento stats site

bento stats segment seg_12345

bento stats report rep_12345

bento skills list

# Install all skills to all detected agents
bento skills install

# Install a specific skill
bento skills install --skill bento

# Install for a specific agent
bento skills install --agent claude-code

# Force overwrite existing installations
bento skills install --force

bento experimental validate-email user@example.com
bento experimental validate-email user@example.com --ip "203.0.113.1" --name "John Doe"

bento experimental guess-gender John

bento experimental geolocate 203.0.113.1

bento experimental blacklist --domain example.com
bento experimental blacklist --ip 203.0.113.1

bento experimental moderate "some user-submitted text"

bento subscribers search "john"

bento subscribers search "john" --json

bento subscribers search "john" --json | jq '.email'

bento subscribers import ./contacts.csv --confirm --quiet

bento subscribers import ./contacts.csv --dry-run

bento subscribers import ./contacts.csv --limit 10 --confirm

# This will prompt for confirmation
bento subscribers import ./contacts.csv

# Skip the prompt (for scripting)
bento subscribers import ./contacts.csv --confirm

bento subscribers import ./contacts.csv --dry-run --sample 5

#!/bin/bash
for file in ./imports/*.csv; do
  echo "Importing $file..."
  bento subscribers import "$file" --confirm --quiet
done
echo "Done!"

#!/bin/bash
# Add to crontab for daily reports
bento stats site --json > "/var/log/bento/stats-$(date +%Y-%m-%d).json"

#!/bin/bash
# Tag a new signup from your app
bento subscribers tag "$EMAIL" --add "new-signup,trial"
bento events track --email "$EMAIL" --event "signed_up" --details "{\"source\": \"$SOURCE\"}"

# GitHub Actions example
- name: Import new subscribers
  env:
    BENTO_PUBLISHABLE_KEY: ${{ secrets.BENTO_PUBLISHABLE_KEY }}
    BENTO_SECRET_KEY: ${{ secrets.BENTO_SECRET_KEY }}
    BENTO_SITE_UUID: ${{ secrets.BENTO_SITE_UUID }}
  run: |
    npm install -g @bentonow/bento-cli
    bento subscribers import ./new-subscribers.csv --confirm

#!/bin/bash
# Send order confirmation
bento emails send \
  --to "$CUSTOMER_EMAIL" \
  --from "orders@yourcompany.com" \
  --subject "Order Confirmation #$ORDER_ID" \
  --html-body "<h1>Thank you for your order!</h1><p>Order #$ORDER_ID has been confirmed.</p>" \
  --personalizations "{\"order_id\": \"$ORDER_ID\", \"total\": \"$TOTAL\"}"

#!/bin/bash
# Add emails to a sequence from a directory of HTML files
SEQUENCE_ID="sequence_abc123"
DELAY=1

for file in ./sequence-emails/*.html; do
  SUBJECT=$(basename "$file" .html | tr '-' ' ')
  bento sequences create-email \
    --sequence-id "$SEQUENCE_ID" \
    --subject "$SUBJECT" \
    --html-file "$file" \
    --delay-interval days \
    --delay-count "$DELAY"
  DELAY=$((DELAY + 1))
done

#!/bin/bash
# Run a report across multiple Bento accounts
for profile in staging production; do
  echo "Stats for $profile:"
  bento profile use "$profile"
  bento stats site --json
done

#!/bin/bash
# Track a purchase from your checkout flow
bento events purchase \
  --email "$CUSTOMER_EMAIL" \
  --amount 4999 \
  --currency USD \
  --key "order_$ORDER_ID" \
  --cart '{"items": [{"product_sku": "SKU123", "product_name": "Pro Plan", "quantity": 1}]}'

export BENTO_PUBLISHABLE_KEY="pk_live_..."
export BENTO_SECRET_KEY="sk_live_..."
export BENTO_SITE_UUID="your-site-uuid"