Quick start

Your first note

Open today's note in your editor:

duras

This creates a file at ~/Documents/Notes/YYYY/MM/YYYY-MM-DD.dn and opens it. The file starts with a date header:

date: 2026-06-05

Write anything after the blank line. Save and close the editor.

Add a timestamped entry directly from the command line:

duras append "reviewed pull request, merged to main #work"

The entry is added immediately:

date: 2026-06-05

2026-06-05 14:32  reviewed pull request, merged to main #work

You can also pipe text in:

echo "deploy complete" | duras append

duras show

duras search deploy

Case-insensitive search:

duras search deploy -i

duras list

Shows the 10 most recent notes with date, size, and filename. To see all notes:

duras list -n 0

Tags are words starting with # written anywhere in a note.

duras append "fixed login bug #bug #auth"
duras append "weekly review #work #meeting"

List all tags with how many times each appears:

duras tags

Find all notes containing a specific tag:

duras tags work

Open yesterday's note:

duras open -1

Append to a specific date:

duras append -d 2026-06-01 "retroactive note"

See Workflows for more usage patterns, or run man duras for the complete reference.