Email Marketer

---

version: "2.0.0" name: email-marketer description: "Plan email campaigns with segmentation, A/B testing, and benchmarking. Use when designing campaigns, segmenting lists, benchmarking rates."

---

Email Marketer

AI toolkit for email marketing operations — configure, benchmark, compare, prompt, evaluate, fine-tune, analyze, cost, usage, optimize, test, and report. All entries are logged locally with timestamps for tracking and audit.

Commands

| Command | Description | |---------|-------------| | email-marketer configure | Configure email marketing settings or record a config entry | | email-marketer benchmark | Run benchmarks or record a benchmark entry | | email-marketer compare | Compare campaigns or record a comparison entry | | email-marketer prompt | Generate or record email prompts | | email-marketer evaluate | Evaluate campaign performance or record an evaluation entry | | email-marketer fine-tune | Fine-tune parameters or record a fine-tuning entry | | email-marketer analyze | Analyze campaign data or record an analysis entry | | email-marketer cost | Track costs or record a cost entry | | email-marketer usage | Track usage metrics or record a usage entry | | email-marketer optimize | Optimize campaigns or record an optimization entry | | email-marketer test | Run A/B tests or record a test entry | | email-marketer report | Generate reports or record a report entry | | email-marketer stats | Show summary statistics across all entry types | | email-marketer export | Export all data (json, csv, or txt) | | email-marketer search | Search across all log entries by keyword | | email-marketer recent | Show the 20 most recent activity entries | | email-marketer status | Health check — version, data dir, entry count, disk usage | | email-marketer help | Show help with all available commands | | email-marketer version | Show current version (v2.0.0) |

Each command (configure, benchmark, compare, prompt, evaluate, fine-tune, analyze, cost, usage, optimize, test, report) works in two modes:

No arguments: displays the 20 most recent entries from that command's log

With arguments: records the input with a timestamp and appends to the command's log file

Data Storage

All data is stored locally at ~/.local/share/email-marketer/. Each action is logged to its own file (e.g., configure.log, benchmark.log, analyze.log). A unified history.log tracks all operations. The built-in export function supports JSON, CSV, and plain text formats.

Requirements

bash 4+ (uses set -euo pipefail)

Standard Unix utilities (wc, du, grep, tail, sed, date)

When to Use

Tracking email campaign configurations and benchmark results

Logging A/B test outcomes and evaluation metrics

Recording cost and usage data for email marketing operations

Fine-tuning campaign parameters with documented history

Analyzing campaign performance trends over time

Exporting marketing data for stakeholder reports

Examples

# Configure a new campaign
email-marketer configure "weekly newsletter — segment: active users, send: Tuesday 9AM"
Record a benchmark result
email-marketer benchmark "open rate 24.5%, click rate 3.2%, industry avg 21%"
Compare two campaigns
email-marketer compare "Campaign A: 28% open vs Campaign B: 22% open"
Evaluate campaign performance
email-marketer evaluate "Q1 drip sequence — 15% conversion, 2.1% unsubscribe"
Record a cost entry
email-marketer cost "March send volume: 50K emails, cost: $45"
Run an A/B test
email-marketer test "Subject line A vs B — A won with 31% open rate"
View recent activity
email-marketer recent
Export all data as CSV
email-marketer export csv
Search for entries about "onboarding"
email-marketer search onboarding
Check overall health
email-marketer status

---

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com

# Configure a new campaign
email-marketer configure "weekly newsletter — segment: active users, send: Tuesday 9AM"
Record a benchmark result
email-marketer benchmark "open rate 24.5%, click rate 3.2%, industry avg 21%"
Compare two campaigns
email-marketer compare "Campaign A: 28% open vs Campaign B: 22% open"
Evaluate campaign performance
email-marketer evaluate "Q1 drip sequence — 15% conversion, 2.1% unsubscribe"
Record a cost entry
email-marketer cost "March send volume: 50K emails, cost: $45"
Run an A/B test
email-marketer test "Subject line A vs B — A won with 31% open rate"
View recent activity
email-marketer recent
Export all data as CSV
email-marketer export csv
Search for entries about "onboarding"
email-marketer search onboarding
Check overall health
email-marketer status

---

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com