Event Planner Pro
Productivity and task management tool for event planning (v2.0.0). Add items to your event task list, mark tasks as done, set priorities, view today's or this week's schedule, set reminders, track statistics, clear completed items, and export your data. All entries are timestamped and stored in a simple log file.
Commands
| Command |
Description |
event-planner-pro add <item> |
Add a new item to the task list. Records the current date and the item text. |
event-planner-pro list |
List all items in the data log. Shows the full task list with dates. |
event-planner-pro done <item> |
Mark a task or item as completed. |
event-planner-pro priority <item> [level] |
Set the priority level for an item. Default level is medium. |
event-planner-pro today |
Show tasks and events scheduled for today (filters by current date). |
event-planner-pro week |
Show this week's overview of planned tasks and events. |
event-planner-pro remind <item> [when] |
Set a reminder for an item. Default time is tomorrow. |
event-planner-pro stats |
Show statistics: total number of items in the task list. |
event-planner-pro clear |
Clear all completed items from the list. |
event-planner-pro export |
Export all data from the task list to stdout. |
event-planner-pro help |
Show the built-in help with all available commands. |
event-planner-pro version |
Print the current version (v2.0.0). |
Data Storage
All data is stored in ~/.local/share/event-planner-pro/ (or the path set by EVENT_PLANNER_PRO_DIR or XDG_DATA_HOME):
- data.log — The main task list. Each line contains a date and the item text.
- history.log — An audit trail of every command executed, with timestamps.
You can customize the data directory by setting the EVENT_PLANNER_PRO_DIR environment variable:
export EVENT_PLANNER_PRO_DIR="$HOME/my-events"
Requirements
- Bash 4.0+ (uses
set -euo pipefail)
- coreutils —
date, wc, grep, cat
- No external dependencies, API keys, or network access required
- Works fully offline on any POSIX-compatible system
When to Use
- Wedding planning — Add all wedding tasks (venue booking, caterer selection, invitation mailing), set priorities, view today's checklist, and mark items done as you go.
- Corporate event coordination — Track conference logistics (speaker confirmations, AV setup, catering orders), use
today to see what needs attention right now, and week for the upcoming schedule.
- Birthday party preparation — Add decorations, cake order, guest list items; use
remind to set follow-ups for RSVPs and vendor confirmations.
- Daily task triage — Start each morning with
event-planner-pro today to see what's due, use priority to rank items, and done to clear them as you complete tasks.
- Post-event cleanup and review — After the event, run
stats to see how many items were tracked, export the full log for archiving, and clear completed items to start fresh for the next event.
Examples
# Add a wedding task
event-planner-pro add "Book photographer — call Studio Lux by Friday"
# Add a catering task
event-planner-pro add "Confirm vegetarian menu options with caterer"
# Set priority on a task
event-planner-pro priority "Book photographer" high
# View today's tasks
event-planner-pro today
# View the week ahead
event-planner-pro week
# Set a reminder
event-planner-pro remind "Send invitations" "next Monday"
# Mark a task as done
event-planner-pro done "Book photographer"
# View statistics
event-planner-pro stats
# Export all tasks for archiving
event-planner-pro export > event-backup.txt
# Clear completed items
event-planner-pro clear
# List everything
event-planner-pro list
Tips
- Use
event-planner-pro list to get a full dump of all tasks, then pipe to grep for filtering: event-planner-pro list | grep "caterer"
- Redirect
export output to a file for backups: event-planner-pro export > archive-2024.txt
- The
today command filters by the current date, so add items with the correct date context for best results.
- Combine with cron for daily reminders:
0 9 * * * event-planner-pro today | mail -s "Today's events" you@example.com
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
1---2name: event-planner-23description: Plan weddings, birthdays, and corporate events with budgets and checklists. Use when drafting budgets, building checklists, or coordinating vendors.4---5
6# Event Planner Pro
7
8Productivity and task management tool for event planning (v2.0.0). Add items to your event task list, mark tasks as done, set priorities, view today's or this week's schedule, set reminders, track statistics, clear completed items, and export your data. All entries are timestamped and stored in a simple log file.
9
10## Commands
11
12| Command | Description |
13|---------|-------------|
14| `event-planner-pro add <item>` | Add a new item to the task list. Records the current date and the item text. |
15| `event-planner-pro list` | List all items in the data log. Shows the full task list with dates. |
16| `event-planner-pro done <item>` | Mark a task or item as completed. |
17| `event-planner-pro priority <item> [level]` | Set the priority level for an item. Default level is `medium`. |
18| `event-planner-pro today` | Show tasks and events scheduled for today (filters by current date). |
19| `event-planner-pro week` | Show this week's overview of planned tasks and events. |
20| `event-planner-pro remind <item> [when]` | Set a reminder for an item. Default time is `tomorrow`. |
21| `event-planner-pro stats` | Show statistics: total number of items in the task list. |
22| `event-planner-pro clear` | Clear all completed items from the list. |
23| `event-planner-pro export` | Export all data from the task list to stdout. |
24| `event-planner-pro help` | Show the built-in help with all available commands. |
25| `event-planner-pro version` | Print the current version (v2.0.0). |
26
27## Data Storage
28
29All data is stored in `~/.local/share/event-planner-pro/` (or the path set by `EVENT_PLANNER_PRO_DIR` or `XDG_DATA_HOME`):
30
31- **data.log** — The main task list. Each line contains a date and the item text.
32- **history.log** — An audit trail of every command executed, with timestamps.
33
34You can customize the data directory by setting the `EVENT_PLANNER_PRO_DIR` environment variable:
35
36```bash
37export EVENT_PLANNER_PRO_DIR="$HOME/my-events"
38```
39
40## Requirements
41
42- **Bash** 4.0+ (uses `set -euo pipefail`)
43- **coreutils** — `date`, `wc`, `grep`, `cat`
44- No external dependencies, API keys, or network access required
45- Works fully offline on any POSIX-compatible system
46
47## When to Use
48
491. **Wedding planning** — Add all wedding tasks (venue booking, caterer selection, invitation mailing), set priorities, view today's checklist, and mark items done as you go.
502. **Corporate event coordination** — Track conference logistics (speaker confirmations, AV setup, catering orders), use `today` to see what needs attention right now, and `week` for the upcoming schedule.
513. **Birthday party preparation** — Add decorations, cake order, guest list items; use `remind` to set follow-ups for RSVPs and vendor confirmations.
524. **Daily task triage** — Start each morning with `event-planner-pro today` to see what's due, use `priority` to rank items, and `done` to clear them as you complete tasks.
535. **Post-event cleanup and review** — After the event, run `stats` to see how many items were tracked, `export` the full log for archiving, and `clear` completed items to start fresh for the next event.
54
55## Examples
56
57```bash
58# Add a wedding task
59event-planner-pro add "Book photographer — call Studio Lux by Friday"
60
61# Add a catering task
62event-planner-pro add "Confirm vegetarian menu options with caterer"
63
64# Set priority on a task
65event-planner-pro priority "Book photographer" high
66
67# View today's tasks
68event-planner-pro today
69
70# View the week ahead
71event-planner-pro week
72
73# Set a reminder
74event-planner-pro remind "Send invitations" "next Monday"
75
76# Mark a task as done
77event-planner-pro done "Book photographer"
78
79# View statistics
80event-planner-pro stats
81
82# Export all tasks for archiving
83event-planner-pro export > event-backup.txt
84
85# Clear completed items
86event-planner-pro clear
87
88# List everything
89event-planner-pro list
90```
91
92## Tips
93
94- Use `event-planner-pro list` to get a full dump of all tasks, then pipe to `grep` for filtering: `event-planner-pro list | grep "caterer"`
95- Redirect `export` output to a file for backups: `event-planner-pro export > archive-2024.txt`
96- The `today` command filters by the current date, so add items with the correct date context for best results.
97- Combine with cron for daily reminders: `0 9 * * * event-planner-pro today | mail -s "Today's events" you@example.com`
98
99---
100*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*
bytesagain