Reminder Research

v3 Evolution: Custom instructions + auto-processing + result tracking

🔧 Setup

Required:

1. Install remindctl: brew install steipete/tap/remindctl
2. Install jq: brew install jq
3. Grant Reminders permission: remindctl authorize

Optional (for web research):

1. Get Brave Search API key: https://brave.com/search/api/
2. Configure: openclaw configure --section web
3. Set BRAVE_API_KEY when prompted

Optional (for book research):

• Install librarian skill (requires external project)

Cron scheduling (recommended):

# Add via OpenClaw cron tool
cron add --schedule "0 3 * * *" --payload "Run reminder-research skill..."

Or run manually:

~/Documents/skills/reminder-research/process-reminders.sh

graph TD
    A[HEARTBEAT trigger] -->|spawns| B[Isolated Session Sub-agent]
    B -->|runs| C[process-reminders.sh]
    
    C -->|queries| D[remindctl all --json]
    D -->|returns| E{Filter incomplete}
    
    E -->|has 💎?| F[SKIP - already processed]
    E -->|no 💎| G{Notes empty?}
    
    G -->|nothing to process| H[NO_REMINDERS_TO_PROCESS]
    H --> I[Exit 0 tokens]
    
    G -->|yes| J[Gen 2: List-based]
    G -->|no| K[Gen 3: Custom]
    
    J -->|claw list| L[CLAW_ITEM]
    J -->|Shopping| M[SHOPPING_ITEM]
    J -->|other| N[GENERIC_ITEM]
    
    K --> O[CUSTOM_ITEM]
    
    L -->|memory_search| P[System analysis]
    M -->|web_search| Q[Product research]
    N -->|web_search| R[Generic research]
    O -->|parse instructions| S[Multi-source: books+web+constraints]
    
    P --> T[Format: 💎 + analysis]
    Q --> T
    R --> T
    S --> T
    
    T -->|remindctl edit| U[Update notes]
    U --> V[Announce summary]
    V --> W[Session ends]

🎯 Three Generations

Gen 1 (Manual - deprecated)

Title: 🔍 Pesquise tarot no livro
Notes: (empty)
→ Manual emoji trigger

Gen 2 (Auto - current baseline)

Title: Stacker bag
Notes: (empty)
→ Auto-detect empty notes
→ List-based behavior (shopping/claw/generic)

Gen 3 (Custom - NEW)

Title: Bitcoin ETF regulation
Notes: "Procure no livro de David Graeber sobre anarchism + web search SEC rulings 2024"
→ Follow custom instructions
→ Output: "💎 [resultado da pesquisa]"

🔑 Signifiers

💎 = RESULT (already processed)

• For Nicholas: "Read the report, it's done"
• For Claw: "Skip this, already researched"

No 💎 = NEEDS PROCESSING

• Empty notes → list-based default behavior
• Notes with instructions → follow custom research path

📋 Processing Logic

Detection

process-reminders.sh

Output types:

NO_REMINDERS_TO_PROCESS          # Nothing to do
CLAW_ITEM|<id>|<title>            # System improvement (empty notes)
SHOPPING_ITEM|<id>|<title>        # Product search (empty notes)
GENERIC_ITEM|<id>|<list>|<title>  # Generic research (empty notes)
CUSTOM_ITEM|<id>|<list>|<title>|<instructions>  # Custom instructions (Gen 3)