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 <input> |
Configure email marketing settings or record a config entry |
email-marketer benchmark <input> |
Run benchmarks or record a benchmark entry |
email-marketer compare <input> |
Compare campaigns or record a comparison entry |
email-marketer prompt <input> |
Generate or record email prompts |
email-marketer evaluate <input> |
Evaluate campaign performance or record an evaluation entry |
email-marketer fine-tune <input> |
Fine-tune parameters or record a fine-tuning entry |
email-marketer analyze <input> |
Analyze campaign data or record an analysis entry |
email-marketer cost <input> |
Track costs or record a cost entry |
email-marketer usage <input> |
Track usage metrics or record a usage entry |
email-marketer optimize <input> |
Optimize campaigns or record an optimization entry |
email-marketer test <input> |
Run A/B tests or record a test entry |
email-marketer report <input> |
Generate reports or record a report entry |
email-marketer stats |
Show summary statistics across all entry types |
email-marketer export <fmt> |
Export all data (json, csv, or txt) |
email-marketer search <term> |
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