bytesagain 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.
bash scripts/script.sh add "morning standup: discussed sprint priorities"
bash scripts/script.sh add "completed code review for PR #142"
bash scripts/script.sh add
plan — Record or view plans
Log planning decisions, goals, or upcoming task outlines.
bash scripts/script.sh plan "Q2 goals: ship v2.0, hire 2 engineers, reduce p50 latency"
bash scripts/script.sh plan "this week: finish API migration, write docs"
bash scripts/script.sh plan
track — Track progress
Record progress on ongoing tasks, habits, or metrics.
bash scripts/script.sh track "reading: finished chapter 7 of DDIA"
bash scripts/script.sh track "exercise: 30min run, 5km"
bash scripts/script.sh track
review — Record reviews
Log review notes — code reviews, sprint retros, or self-reflection.
bash scripts/script.sh review "sprint retro: deployment process needs automation"
bash scripts/script.sh review "1:1 feedback: improve async communication"
streak — Track streaks
Record streak milestones for habits or daily practices.
bash scripts/script.sh streak "coding: day 45 consecutive"
bash scripts/script.sh streak "meditation: day 12"
bash scripts/script.sh streak
remind — Set reminders
Log reminders and follow-up items.
bash scripts/script.sh remind "follow up with vendor on contract renewal by Friday"
bash scripts/script.sh remind "dentist appointment next Tuesday 2pm"
prioritize — Record priorities
Log prioritization decisions and task rankings.
bash scripts/script.sh prioritize "P0: fix auth bug, P1: deploy monitoring, P2: update docs"
bash scripts/script.sh prioritize "today: database migration > API tests > code review"
archive — Archive entries
Mark items as archived or log archival operations.
bash scripts/script.sh archive "moved Q1 OKRs to archive"
bash scripts/script.sh archive "closed 14 stale tickets from backlog"
tag — Tag entries
Add tags or categorizations to organize your log data.
bash scripts/script.sh tag "project:atlas, type:bugfix, severity:high"
bash scripts/script.sh tag "#learning #rust #systems"
timeline — Record timeline events
Log chronological milestones and key events.
bash scripts/script.sh timeline "v2.0 released to production"
bash scripts/script.sh timeline "team offsite: Tokyo, March 15-17"
report — Generate or record reports
Log report creation or summary observations.
bash scripts/script.sh report "weekly status: 12 PRs merged, 3 bugs fixed, 1 incident"
bash scripts/script.sh report "monthly review: on track for Q2 targets"
weekly-review — Weekly review entries
Record weekly review summaries for reflection and planning.
bash scripts/script.sh weekly-review "good: shipped search feature. improve: testing coverage"
bash scripts/script.sh weekly-review "wins: closed 8 tickets. blockers: CI flakiness"
stats — Summary statistics
Show entry counts per category, total entries, data size, and earliest recorded activity.
bash scripts/script.sh stats
export — Export all data
Export all logged entries to JSON, CSV, or plain text format.
bash scripts/script.sh export json
bash scripts/script.sh export csv
bash scripts/script.sh export txt
search — Search across all entries
Search all log files for a keyword (case-insensitive).
bash scripts/script.sh search "sprint"
bash scripts/script.sh search "meditation"
recent — View recent activity
Show the last 20 entries from the global activity history.
bash scripts/script.sh recent
status — Health check
Display version, data directory, total entries, disk usage, and last activity timestamp.
bash scripts/script.sh status
help / version
bash scripts/script.sh help
bash scripts/script.sh version
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,weekly-review.log - Activity history:
history.log— global log of all operations with timestamps - Exports:
export.json,export.csv, orexport.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
- Daily work journaling — Use
addthroughout the day to capture what you did, decisions made, and things learned - Sprint planning and retros — Combine
plan,review, andweekly-reviewfor agile workflow documentation - Habit tracking — Use
trackandstreakto build accountability for daily habits (exercise, reading, coding) - Priority management — Log priority decisions with
prioritizeand set follow-ups withremind - Long-term reflection — Export monthly data with
export jsonand usetimelineto mark significant milestones
Examples
# Start your day with a plan
bash scripts/script.sh plan "today: fix auth bug, review PR #200, update API docs"
# Track progress throughout the day
bash scripts/script.sh add "fixed auth token refresh — was using expired key"
bash scripts/script.sh track "PR #200 reviewed, left 3 comments"
bash scripts/script.sh tag "#bugfix #auth #security"
# End-of-week review
bash scripts/script.sh weekly-review "shipped: auth fix, search feature. next: monitoring dashboard"
bash scripts/script.sh stats
# Search and export
bash scripts/script.sh search "auth"
bash scripts/script.sh export json
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com