Task Management Commands

Commands for managing your personal task list with importance levels and smart duplicate handling.

add

Add a new task or update an existing one with an importance level.

Syntax

rmd add "TASK_DESCRIPTION" PRIORITY_LEVEL

Parameters

Parameter	Type	Description
TASK_DESCRIPTION	string	Description of the task (quoted if contains spaces)
PRIORITY_LEVEL	integer	Priority level from 1-10 (higher = more important)

Examples

# Add basic task
rmd add "Complete project proposal" 8

# Add task with spaces in description
rmd add "Review pull request #123" 5

# Add high-priority task
rmd add "Call dentist" 9

Smart Duplicate Handling

If you add a task with the same description as an existing task, it updates the priority level instead of creating a duplicate:

# Initial task
rmd add "Buy groceries" 3

# Update importance (no duplicate created)
rmd add "Buy groceries" 6

rm

Remove one or more tasks by description or ID.

Syntax

rmd rm TASK_IDENTIFIER [TASK_IDENTIFIER...]

Parameters

Parameter	Type	Description
TASK_IDENTIFIER	string/integer	Task description (quoted) or task ID number (from rmd ls)

Examples

# Remove by description
rmd rm "Buy groceries"

# Remove multiple tasks by description
rmd rm "Call dentist" "Organize desk"

# Remove by task ID
rmd rm 1 2 3

ls

List all tasks sorted by urgency and importance (highest first).

Syntax

rmd ls

Examples

# Basic task list
rmd ls

Procrastinate Tag

At each configured daily_urgent / daily_urgency time, the reminder service opens a task-by-task popup for high-priority tasks (priority 8-10). For each task:

• Click Yes to mark it complete and remove it from tasks.json
• Click No to keep it and mark it as procrastinated
• Click Stop to leave the remaining urgent tasks unchanged

Tasks you mark as not completed are recorded in a procrastinate list file:

• tasks/procrastinate.json under your REMINDER_CONFIG_DIR
• Each entry stores the task description and the first day it was deferred

In rmd ls, procrastinated tasks are shown with:

• A ⏳ prefix
• A procrastination age label such as (deferred today) or (3 days)
• A dim/italic text style

In later urgent-task popups, the reminder also shows how many days the task has already been procrastinated.

When a procrastinated task is complete (rmd rm), it is automatically removed from tasks/procrastinate.json.

---

Habit Management Commands

Commands for interacting with your configured daily habits.

track

Log completed habits for today. Habits are loaded from habits.toml.

Syntax

rmd track [HABIT_IDS...]

Parameters

Parameter	Type	Description
HABIT_IDS	array of strings	(Optional) Space-separated list of Habit IDs to mark completed for today.

Examples

# Mark habits 1 and 2 as completed for today
rmd track 1 2

# Open an interactive prompt window to tick off habits
rmd track