meetup-planner

# Meetup Planner

An intelligent assistant that helps you discover, track, and never miss events that match your interests.

## One-time Setup

**IMPORTANT**: After installing this skill, the agent will automatically run the bootstrap setup process from `BOOTSTRAP.md`.

The bootstrap process:
1. Checks for web search and crawling capabilities
2. Collects your event preferences
3. Sets up automated daily searches (optional)
4. Creates workspace structure

If you don't have search/crawling capabilities, I'll ask you to provide the necessary tools.

## What This Skill Does

After setup:
1. **Daily Search**: Automatically searches for events matching your profile every morning (if enabled)
2. **Event Discovery**: Uses available search and scraping tools to find events across the web
3. **Event Tracking**: Saves and presents new events for your review
4. **Smart Reminders**: Sets up notifications 24 hours and 2 hours before confirmed events
5. **Preference Management**: Updates your interests and search criteria anytime

## First Time Setup

**When you first run this skill**, I will guide you through setup by following `BOOTSTRAP.md`.

The setup process is **interactive and friendly**:

1. ✅ Check for web search and crawling capabilities
2. 🎯 Learn your event preferences through a friendly conversation
3. ⏰ Set up automated daily searches (optional)
4. 📁 Create workspace structure with proper permissions

**Setup takes 2-3 minutes**. If you don't have search/crawling tools installed, I'll ask you to provide them.

## How to Use

### Initial Run
```
Run the meetup-planner skill to begin setup
```

### Daily Operations
Once set up, the skill will:
- Search for events every morning automatically
- Save findings to `events.json`
- Present new events for your review
- Track events you're interested in

### When You Find an Event You Like
Tell me "I'm interested in [event name]" and I will:
- Mark it as confirmed
- Send you the registration link
- Set up reminders (24h and...

# Meetup Planner

Never miss an event that matches your interests! This OpenClaw skill automatically finds, tracks, and reminds you about meetups, conferences, workshops, and other events tailored to your preferences.

## 🎯 Features

- **🔍 Intelligent Search**: Uses available search and scraping tools to discover events across the web
- **🤖 Automated Daily Scanning**: Searches every morning for new events matching your profile
- **📊 Smart Tracking**: Maintains a local database of discovered events
- **⏰ Timely Reminders**: Notifies you 24 hours and 2 hours before registered events
- **🎨 Personalized**: Learns your preferences for topics, locations, formats, and schedules
- **🔒 Privacy-First**: All data stored locally on your machine

## 📦 Installation

### Prerequisites

**Web Search and Scraping Tools**:
- You'll need a web search tool/skill (any search capability)
- You'll need a web scraping/crawling tool/skill (any scraping capability)
- The skill will detect what you have available during setup

### Install via ClawHub

```bash
# The installer will prompt you to review security settings
npx clawhub@latest install meetup-planner
```

**⚠️ Security Note**: Before installation, the installer will show security requirements and ask for confirmation. Review the permissions carefully.

### Manual Installation

```bash
# Clone or download this skill
git clone https://github.com/apresmoi/meetup-planner.git

# Copy to your Claude skills directory
mkdir -p ~/.claude/skills/meetup-planner
cp -r meetup-planner/* ~/.claude/skills/meetup-planner/
```

## 🚀 Quick Start

1. **Initial Setup**: Invoke the skill in your Claude session. It will:
   - Check for available search and scraping capabilities
   - Interview you about your event preferences
   - Set up daily automated searches

2. **Daily Use**: The skill runs automatically every morning to find new events

3. **Review Events**: When new events are found, you'll be notified to review them

4. **Register for Event...