CLI client for the Regroup Mass Notification API.
go install github.com/Folger-Shakespeare-Library/regroup-cli/cmd/regroup@latest
regroup config init
Prompts for API key and secret. Credentials are stored in ~/.config/regroup/config.json (mode 0600).
regroup contacts list
regroup contacts list --email user@example.com
regroup contacts list --group technology
regroup contacts add --email user@example.com --group technology --first-name Jane --last-name Doe
regroup contacts remove --email user@example.com --group technology
regroup groups list
regroup groups contacts <group-slug>
regroup channels list
regroup channels contacts <channel-slug>
regroup config show
regroup config path
Default output is JSON. Use --output table for tabular output. Pipe to jq for filtering:
regroup contacts list | jq '.[] | select(.groups | any(. == "Technology"))'
Exit code 0 on success, no output. Non-zero on error, message to stderr.
Groups and channels are specified by slug (lowercase, hyphens for spaces). Use regroup groups list or regroup channels list to see available slugs.
--group accepts repeated flags or comma-separated values:
regroup contacts add --email user@example.com --group technology --group staff
regroup contacts add --email user@example.com --group technology,staff
This CLI covers contacts, groups, and channels. The Regroup API also supports messages, events, and other endpoints not yet implemented here.