email-marketer

version	1.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 <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 | [e-mail]