HarborLog is a personal Node.js diary for harbor-side ideas, tasks, and cargo notes. It logs short bursts of work so that the solo developer can remember what happened between real-life shifts. This project mirrors how a developer might iterate on a real tool: small features, frequent commits, and practical usage notes.
- store harbor tasks with statuses, vessel names, and sentiment tags
- tag entries with effort, intent, and follow-up notes for later review
- filter and export concise summaries for email hand-off
npm install
node src/cli.js add --note "Plan berth sensor check" --ship "Lynx"harborlog addrecords a quick note with metadata so evening shifts stay organized.harborlog listshows the most recent entries by status, and you can filter by vessel/project name.harborlog summarygives a snapshot of total logs and their mix of statuses.harborlog exportprints a markdown digest plus a short report for handoffs during office hours.
See docs/roadmap.md for what I keep in mind between weekends and how this journal might grow.
The config/defaults.json file holds the statuses and effort levels that feel natural for this diary, so I can tune the weekend shorthand without breaking the export scripts.
- Add quiet notes to the journal, tagging them with metadata.
- Use the summary commands to review ideas before the next weekend shift.
- Export to JSON/markdown when ready to polish release notes during office hours.
The SessionNotebook helper in src/lib/notebook.js gathers your most recent entries and can turn a quick reflection into a new log entry with tags. It keeps the solo work human: weekend sparks stay light enough to revisit during free hours.