followup

name	followup
description	Schedule a follow-up reminder for a specific date. Use when user wants to set a reminder to follow up on a project, task, question, or any item. Adds entries to _Followups.md which get pulled into daily notes.

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"