duely

A CLI for tracking recurring maintenance tasks. Know what's due, mark it done, and keep a log.

Why duely?

• Simple recurring tasks — No calendar overhead for maintenance chores
• Overdue alerts — See what you've been putting off
• Execution log — Know when things last ran

Installation

brew tap halbotley/tap
brew install duely

Commands

Add a recurring task

duely add backups --name "Database backups" --every 1d
duely add vault-review --name "Vault review" --every 3d
duely add oil-change --name "Oil change" --every 90d --start 2025-06-01

Intervals: 12h, 1d, 3d, 1w, 30d, 90d, etc.

List all tasks

duely list

Show tasks that are due now

duely due

Shows overdue tasks with ⚠️ warnings.

Mark a task as done

duely run backups
duely run backups --notes "Full backup completed"

Skip a task (reschedule without running)

duely skip vault-review
duely skip vault-review --reason "On vacation"

View execution log

duely log

Remove a task

duely remove old-task

Agent Integration

duely works well with agent heartbeats or cron-triggered checks:

# Check for due tasks and act on them
duely due
# After completing the task:
duely run <task-id> --notes "Completed by agent"

Notes

• Task IDs must be lowercase with no spaces
• --start defaults to now if not specified
• --every accepts hours (h), days (d), and weeks (w)
• Data stored locally in ~/.duely/