New advertisers: 50% off your first month with code FIRSTMONTHSee slots

Batch client email updates into one scheduled digest with an urgent override.

version
0.1.0
GitHub stars
32
View on GitHub

What it does

  • Adds 7 skills (setup, setup-server, manage-team, manage-recipients, queue-update, batch-status, release-batch) for queuing and releasing client email
  • Covers queued updates per client, daily or weekly digests, threshold sends, and manual release ahead of schedule
  • Enforces a 5-minute tick on a server so urgent items send at once while other batches wait for their agreed time
  • Designed for consultants and small teams that keep one client informed without flooding their inbox

Batch client email updates into one daily/weekly digest: a team queues updates, a server sends them on schedule, urgent ones go at once.

Add marketplace

/plugin marketplace add danielrosehill/Claude-Code-Plugins

Run it inside Claude Code once, then install the plugin below.

Install

/plugin install email-batcher@danielrosehill

Run it inside Claude Code after adding the marketplace.

Files

Discovered from source

Queue status

The CLI

All work goes through emailbatcher.py (stdlib Python, JSON on stdout). Call it as $EB below:

  • Once a deployment exists, use the copy inside it: python3 <deployment>/bin/emailbatcher.py.
  • Before that (setup), use ${CLAUDE_PLUGIN_ROOT}/scripts/emailbatcher.py, or fetch https://raw.githubusercontent.com/danielrosehill/EmailBatcher/main/scripts/emailbatcher.py if the plugin is not installed locally.

The workstation client config (deployment path + who this user is) lives at ${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/email-batcher/config.json. If it is missing, run the setup skill first.

Steps

  1. Pull first so the view is current: git -C <deployment> pull --rebase -q (skip if not a git repo).
  2. $EB status [<recipient>] -v
  3. Report per recipient in a short table: pending count, urgent pending, next release (local time), last release, last_error if set. List items only if asked or if there are five or fewer.
  4. A non-null last_error means the server's last attempt failed and the items are still queued. Say so and show the error.

Readme

EmailBatcher

A Claude Code plugin that holds outbound email updates in a queue and sends one consolidated email per recipient on a schedule (daily, weekly, or at a threshold). If something can't wait, an urgent override sends it straight away.

It's built for consultants and small teams keeping a client informed. Several people queue updates through the day, and a server sends the client one digest at the agreed time from an agreed address, so the client isn't buried in small updates.

How it works

  • The deployment is a private git repo of markdown and JSON files: team profiles, recipients and their cadence, and the queue. Each queued update is its own file, so several people can push at once.
  • A server runs tick every 5 minutes (systemd timer or cron). It sends urgent items, releases every batch that's due, and pushes the result back. Workstations don't need to be on.
  • One stdlib Python CLI does all the work (scripts/emailbatcher.py). It needs no dependencies and outputs JSON.

Full design: docs/design.md.

Skills

  • setup: create a deployment, or join one as a team member.
  • setup-server: install the release runner on a server.
  • manage-team: add team member profiles.
  • manage-recipients: client addresses, cadence, send time, thresholds, urgent policy.
  • queue-update: queue an update for the next batch (or send it urgently).
  • batch-status: what's pending, and when it goes out.
  • release-batch: preview, send now, or withdraw an item.

Installation

claude plugins install email-batcher@danielrosehill

CLI quick reference

EB="python3 scripts/emailbatcher.py"
$EB init ~/repos/acme-email-batches --name "Acme" --sender-email updates@example.com --timezone Europe/London --transport resend
$EB add-user alice --deployment ~/repos/acme-email-batches --name "Alice"
$EB add-recipient acme --deployment ~/repos/acme-email-batches --to ceo@acme.test --cadence daily --at 17:00 --days mon,tue,wed,thu,fri
$EB configure-client --deployment ~/repos/acme-email-batches --user alice
$EB queue acme --subject "DNS cutover done" --topic Website --body "Finished at 14:00."
$EB queue acme --subject "Site down" --body "Investigating." --urgent
$EB status -v
$EB preview acme
$EB tick            # what the server runs

Prior art

This plugin builds on Client-Update-Pipeline-Notes and Agent-Briefing-Gateway.

License

MIT

Details

Marketplace
danielrosehill/Claude-Code-Plugins
Source
danielrosehill/EmailBatcher
Author
Daniel Rosehill
Category
Personal Productivity
License
MIT

More from danielrosehill/Claude-Code-Plugins

All 264

Similar to email-batcher

More Communication