Reminder Management

Vigilare provides full-featured task management with instant sync to Apple Reminders. Add, edit, complete, and delete tasks without ever leaving your workflow.

Adding New Reminders

Create tasks quickly without interrupting your work.

Quick Add Bar

The fastest way to add a reminder.

Location: Bottom of the Vigilare window

How to Use:

1. Click in the text field (or press Tab to focus)
2. Type your task
3. Press Enter to create

Features:

• Adds to currently selected list
• Tasks sync to Apple Reminders instantly
• New task appears at top of incomplete tasks
• Field clears automatically for next task

Example Workflow:

Typing in quick add:
"Review pull request #123" → Enter
"Update documentation" → Enter
"Fix login bug" → Enter

Result: Three tasks created in seconds

Keyboard Shortcut

Add New Task: Focus is automatic when window is active, just start typing in the add bar.

Editing Reminders

Modify task details without switching to Apple Reminders.

Quick Edit

How to Access:

• Double-click any reminder in the list
• Or select a reminder and press Enter
• Or use Edit button from context menu

Edit Window Opens:

• Title field with current text
• Notes editor (Markdown supported)
• Date picker for due dates
• Priority selector
• List assignment
• Subtask management

What You Can Edit

Task Title:

• Main task description
• Rename or clarify tasks
• Fix typos

Notes (via Markdown editor):

• Detailed task information
• Rich formatting
• Links and references
• See Markdown Editor for full features

Due Date:

• Set or change due date
• Remove due date
• Use date picker interface

Priority:

• None, Low, Medium, High
• Visual indicators in list view

List Assignment:

• Move task to different list
• Dropdown shows all available lists

Subtasks:

• Add new subtasks
• Edit existing subtasks
• Remove subtasks
• Reorder subtasks

Saving Changes

Three Ways to Save:

1. Click "Save" button
2. Press ⌘S (keyboard shortcut)
3. Changes auto-save periodically

Cancel Editing:

• Click "Cancel" button
• Press Escape key
• Changes are discarded

Completing Tasks

Mark tasks as done with instant feedback.

Toggle Completion

Click Checkbox:

• Click the circle checkbox next to any task
• Task marked as complete immediately
• Syncs to Apple Reminders
• Task moves to bottom of list (completed section)

Visual Feedback:

• Checkbox fills with checkmark
• Task title gets strikethrough
• Task becomes grayed out
• Moves to completed section after brief delay

Keyboard Shortcut:

• Select a task (click it)
• Press Space to toggle completion
• Works on both incomplete and completed tasks

Uncompleting Tasks

Reopen a Task:

• Click the filled checkbox on a completed task
• Checkbox becomes empty
• Task returns to incomplete section
• Strikethrough removed

Use Case:

Scenario: Task marked complete by accident
1. Scroll to completed section
2. Click filled checkbox
3. Task returns to active list

Deleting Reminders

Remove tasks permanently with confirmation.

How to Delete

Context Menu:

1. Right-click on any reminder
2. Select "Delete"
3. Confirm deletion in dialog

Delete Button:

1. Hover over a reminder
2. Click the trash icon that appears
3. Confirm deletion

Confirmation Dialog:

• Prevents accidental deletion
• "Are you sure you want to delete this reminder?"
• Delete or Cancel buttons

What Gets Deleted

Single Task:

• Task removed from Vigilare
• Removed from Apple Reminders
• Subtasks also deleted
• Cannot be undone

With Subtasks:

• Parent task deleted
• All subtasks deleted
• Entire task hierarchy removed

Deletion Syncing

Instant Sync:

• Deletion reflects in Apple Reminders immediately
• Syncs to iCloud
• Removed from all devices
• Permanent action

Subtask Management

Work with nested tasks efficiently.

Viewing Subtasks

In Main List:

• Parent tasks show subtask count
• Expandable/collapsible view
• Indented display
• Separate completion tracking

In Edit View:

• Full subtask list
• Add/edit/delete subtasks
• Reorder by drag and drop

Adding Subtasks

From Edit Window:

1. Double-click parent task
2. Scroll to subtasks section
3. Click "Add Subtask"
4. Enter subtask title
5. Save changes

Multiple Subtasks:

• Add as many as needed
• Each has own completion status
• All sync to Apple Reminders

Completing Subtasks

Individual Completion:

• Click checkbox next to subtask
• Parent task completion unaffected
• Tracks progress toward parent completion

Parent Completion:

• Complete parent task
• Doesn't auto-complete subtasks
• Subtasks maintain individual status

Subtask Best Practices

Breaking Down Work:

Parent: "Launch new feature"
├─ Design UI mockups
├─ Implement backend API
├─ Write frontend components
├─ Add unit tests
└─ Update documentation

Daily Tasks:

Parent: "Morning routine"
├─ Check emails
├─ Review PRs
├─ Update project board
└─ Daily standup

Quick Date Management

Reschedule tasks without opening full edit view.

Quick Date Picker

How to Access:

1. Hover over a reminder
2. Click the calendar icon that appears
3. Date picker opens

Quick Options:

• Today
• Tomorrow
• This Weekend
• Next Week
• Remove Due Date
• Custom Date (calendar picker)

Instant Update:

• Click any option
• Date updates immediately
• Syncs to Apple Reminders
• Closes automatically

Use Cases

Quick Reschedule:

Task due today but can't finish:
1. Click calendar icon
2. Select "Tomorrow"
3. Done in 2 clicks

Batch Rescheduling:

Multiple tasks need moving:
1. Click calendar on task 1 → Tomorrow
2. Click calendar on task 2 → Tomorrow
3. Repeat for others
4. Faster than opening each edit window

Search and Filter

Find tasks quickly across all reminders.

Search Functionality

Search Bar:

• Located at top of window
• Magnifying glass icon
• Type to search instantly

What Gets Searched:

• Task titles
• Task notes (partial)
• Subtask titles
• Real-time filtering

Search Behavior:

• Results update as you type
• Highlights matches
• Searches across current list selection
• Clear with X button

Example:

Search: "bug"
Results show:
- "Fix login bug"
- "Bug in checkout flow"
- "Debug payment issue"

Completion Tracking

Visual feedback for task progress.

Task States

Incomplete Tasks:

• Empty circle checkbox
• Normal text color
• Sorted by due date, then creation
• Main section of list

Completed Tasks:

• Filled checkbox with checkmark
• Strikethrough text
• Grayed out appearance
• Bottom section of list

Overdue Tasks:

• Due date in red
• Higher visual priority
• Sorted to top of incomplete section

Progress Indicators

List Level:

• Task count shows incomplete count
• "(5)" means 5 incomplete tasks
• Completed tasks not counted

Visual Separation:

• Clear divider between incomplete and completed
• Completed section collapsible
• Focus on active work

Sync Behavior

Understanding how changes sync to Apple Reminders.

Real-Time Sync

Instant Actions:

• Task creation → appears in Reminders immediately
• Task completion → marked done in Reminders
• Task deletion → removed from Reminders
• Edits → updated in Reminders

Sync Indicators:

• No loading spinners needed
• Changes are atomic
• Syncs automatically
• iCloud propagates to other devices

Offline Capability

Works Offline:

• All operations function without internet
• Changes stored locally
• Sync when connection restored
• No data loss

iCloud Sync:

• Requires internet for cross-device sync
• Local changes always work
• Conflicts resolved by most recent change

Conflict Resolution

Same Task Edited:

• Most recent change wins
• Applies to both Vigilare and Reminders edits
• No manual resolution needed
• Conflicts resolved automatically

Keyboard Navigation

Work faster with keyboard shortcuts.

Selection Navigation

Move Selection:

• ↑ (Up Arrow): Move to previous task
• ↓ (Down Arrow): Move to next task
• Selection visually highlighted

Actions on Selected Task:

• Enter: Open edit window
• Space: Toggle completion
• ⌘E: Edit in Markdown editor (when supported)

See Keyboard Shortcuts for complete list.

Common Workflows

The Quick Capture

Interrupt arrives:
1. Focus Vigilare window (always visible)
2. Type task in quick add
3. Press Enter
4. Back to work in 5 seconds

The Daily Review

Morning routine:
1. Scan incomplete tasks
2. Check overdue items
3. Reschedule using date picker
4. Complete yesterday's finished work
5. Add today's new tasks

The Task Refinement

Weekly planning:
1. Double-click task for details
2. Add notes with context
3. Break into subtasks
4. Set realistic due dates
5. Assign to appropriate list

The Cleanup

End of week:
1. Complete finished tasks
2. Delete obsolete tasks
3. Reschedule pending work
4. Archive completed projects
5. Start fresh next week

Best Practices

Task Naming

Be Specific:

• ❌ "Work on project"
• ✅ "Review design mockups for dashboard"

Include Context:

• ❌ "Call"
• ✅ "Call John about Q4 budget"

Keep Actionable:

• ❌ "Website issues"
• ✅ "Fix broken image on homepage"

When to Use Subtasks

Good Uses:

• Multi-step tasks
• Project milestones
• Checklists
• Sequential work

Bad Uses:

• Single-action tasks
• Unrelated items grouped together
• Over-fragmentation

Due Date Strategy

Set Due Dates For:

• Hard deadlines
• Time-sensitive tasks
• Scheduled meetings/calls

Skip Due Dates For:

• Someday/maybe tasks
• Ongoing work
• Reference items

Related Features

• List Management - Organize tasks by project
• Markdown Editor - Rich notes for tasks
• Keyboard Shortcuts - Work faster
• Search - Find tasks quickly