PartyCraft — 活动策划助手

PartyCraft is a full-featured event planning assistant that runs entirely from the command line. Create events (weddings, birthdays, corporate gatherings, parties), manage budgets, track tasks with completion status, maintain guest lists with RSVP tracking, view countdown timelines, and generate suggested checklists by event type. All data is stored locally in JSON format.

Commands

Data Storage

All data is stored locally in ~/.partycraft/:

• - events.json — Main data file containing all events as a JSON array. Each event object includes:

The directory is created automatically on first run. The events.json file is initialized as an empty array [] if it doesn't exist.

Requirements

• - bash (any modern version)
• python3 (standard library only — uses json, time, datetime)
• No API keys, no network access, no external dependencies

When to Use

1. 1. Planning a wedding — Create the event, use checklist wedding for a suggested task list (venue, catering, photographer, flowers, seating, music, cake, rehearsal dinner), add tasks, track guest RSVPs, and set the budget.
2. Organizing a birthday party — Create a birthday event, get a suggested checklist (theme, invitations, cake, decorations, games, food, party favors), add and track tasks as you complete them.
3. Managing a corporate event — Create a corporate event with objectives, agenda, AV equipment, catering, and name badges tracked as tasks. Monitor completion with task list.
4. Tracking event countdown — Use timeline <id> to see how many days remain, get warnings when less than a week out (⚠️), and monitor task completion percentage.
5. Managing guest lists — Add guests with guest <id> add <name>, view the full list with RSVP status, and track headcount alongside budget and task progress in list.

Examples

CODEBLOCK0

Checklist Templates

PartyCraft includes built-in checklist templates for common event types:

• - Wedding — Venue, invitations, catering, photographer, flowers, seating, music/DJ, cake, rehearsal dinner, final guest count
• Birthday — Theme, invitations, cake, decorations, activities/games, food/drinks, party favors
• Corporate — Objectives, venue, invitations, AV equipment, agenda/speakers, catering, name badges, follow-up materials
• General — Date/time, venue, guest list, invitations, food/drinks, decorations, entertainment, cleanup plan

Output

All output is printed to stdout. Event data is persisted in ~/.partycraft/events.json and can be viewed or edited directly.