Diary

A productivity logging and tracking toolkit. Record entries across 13 categories — add, plan, track, review, streak, remind, prioritize, archive, tag, timeline, report, and weekly-review. Each command stores timestamped entries locally with full activity history, search, statistics, and multi-format export.

Commands

add — Add a diary entry

Record a new entry or view recent entries. Called with no arguments, shows the last 20 entries.

CODEBLOCK0

plan — Record or view plans

Log planning decisions, goals, or upcoming task outlines.

CODEBLOCK1

track — Track progress

Record progress on ongoing tasks, habits, or metrics.

CODEBLOCK2

review — Record reviews

Log review notes — code reviews, sprint retros, or self-reflection.

CODEBLOCK3

streak — Track streaks

Record streak milestones for habits or daily practices.

CODEBLOCK4

remind — Set reminders

Log reminders and follow-up items.

CODEBLOCK5

prioritize — Record priorities

Log prioritization decisions and task rankings.

CODEBLOCK6

archive — Archive entries

Mark items as archived or log archival operations.

CODEBLOCK7

tag — Tag entries

Add tags or categorizations to organize your log data.

CODEBLOCK8

timeline — Record timeline events

Log chronological milestones and key events.

CODEBLOCK9

report — Generate or record reports

Log report creation or summary observations.

CODEBLOCK10

weekly-review — Weekly review entries

Record weekly review summaries for reflection and planning.

CODEBLOCK11

stats — Summary statistics

Show entry counts per category, total entries, data size, and earliest recorded activity.

CODEBLOCK12

export — Export all data

Export all logged entries to JSON, CSV, or plain text format.

CODEBLOCK13

search — Search across all entries

Search all log files for a keyword (case-insensitive).

CODEBLOCK14

recent — View recent activity

Show the last 20 entries from the global activity history.

CODEBLOCK15

status — Health check

Display version, data directory, total entries, disk usage, and last activity timestamp.

CODEBLOCK16

help / version

CODEBLOCK17

Data Storage

All data is stored locally in ~/.local/share/diary/:

• - Per-command logs: add.log, plan.log, track.log, review.log, streak.log, remind.log, prioritize.log, archive.log, tag.log, timeline.log, report.log, INLINECODE31
• Activity history: history.log — global log of all operations with timestamps
• Exports: export.json, export.csv, or export.txt (generated on demand)

Each entry is stored as YYYY-MM-DD HH:MM|<value> with pipe-delimited fields.

Requirements

• - bash 4+
• grep, wc, du, tail, head, cat, date, basename (standard coreutils)
• No external dependencies

When to Use

1. 1. Daily work journaling — Use add throughout the day to capture what you did, decisions made, and things learned
2. Sprint planning and retros — Combine plan, review, and weekly-review for agile workflow documentation
3. Habit tracking — Use track and streak to build accountability for daily habits (exercise, reading, coding)
4. Priority management — Log priority decisions with prioritize and set follow-ups with INLINECODE44
5. Long-term reflection — Export monthly data with export json and use timeline to mark significant milestones

Examples

CODEBLOCK18