duely
# 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
```bash
brew tap halbotley/tap
brew install duely
```
## Commands
### Add a recurring task
```bash
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
```bash
duely list
```
### Show tasks that are due now
```bash
duely due
```
Shows overdue tasks with ⚠️ warnings.
### Mark a task as done
```bash
duely run backups
duely run backups --notes "Full backup completed"
```
### Skip a task (reschedule without running)
```bash
duely skip vault-review
duely skip vault-review --reason "On vacation"
```
### View execution log
```bash
duely log
```
### Remove a task
```bash
duely remove old-task
```
## Agent Integration
duely works well with agent heartbeats or cron-triggered checks:
```bash
# 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/`
标签
skill
ai