Follow-up Scheduler

Schedule follow-up reminders that appear in daily notes on the specified date.

Usage

/followup [date] [description]

Examples:

• /followup 2025-12-23 Check deployment status

• /followup next monday Ask Alex about hiring decision

• /followup +3 Review PR feedback

Date Formats

Accept flexible date input:

• ISO format:

  2025-12-23

• Relative:

  tomorrow

  ,

  next monday

  ,

  next friday

• Offset:

  +3

  (3 days from now),

  +1w

  (1 week from now)

Workflow

1. Parse the date from input (first argument)
2. Parse the description (remaining arguments)
3. Convert to ISO date format (YYYY-MM-DD)
4. Append to

   _Followups.md

   in the vault

File Location

• Vault:

  /Users/larslevie/Library/Mobile Documents/iCloud~md~obsidian/Documents/Real Geeks/

• File:

  _Followups.md

Entry Format

Markdown table row:

| 2025-12-23 | Check deployment status | pending |

Status values:

pending

,

done

Implementation

import datetime
import re

def parse_date(date_str):
    today = datetime.date.today()

    # ISO format
    if re.match(r'\d{4}-\d{2}-\d{2}', date_str):
        return date_str

    # Relative days
    if date_str == 'tomorrow':
        return (today + datetime.timedelta(days=1)).isoformat()

    # Offset: +N or +Nw
    if date_str.startswith('+'):
        if date_str.endswith('w'):
            weeks = int(date_str[1:-1])
            return (today + datetime.timedelta(weeks=weeks)).isoformat()
        else:
            days = int(date_str[1:])
            return (today + datetime.timedelta(days=days)).isoformat()

    # next [weekday]
    if date_str.startswith('next '):
        weekday = date_str[5:].lower()
        days = {'monday': 0, 'tuesday': 1, 'wednesday': 2, 'thursday': 3,
                'friday': 4, 'saturday': 5, 'sunday': 6}
        target = days.get(weekday)
        if target is not None:
            current = today.weekday()
            diff = (target - current + 7) % 7
            if diff == 0:
                diff = 7
            return (today + datetime.timedelta(days=diff)).isoformat()

    return None

After Adding

1. Read current

   _Followups.md

2. Insert new row before the empty line after the table header
3. Confirm to user with the parsed date and description

Example confirmation:

Added follow-up for 2025-12-23: "Check deployment status"