Log books, track reading habits, and review reading streaks over time. Use when recording reads, maintaining goals, or analyzing genre preferences.
Bookworm v2.0.0 — a productivity toolkit for logging, planning, tracking, reviewing, and organizing your work and reading habits from the command line.
| Command | Usage | Description |
|---|---|---|
add | bookworm add <input> | Add a new entry (book, task, note) to your log |
plan | bookworm plan <input> | Record a plan or goal for future action |
track | bookworm track <input> | Track progress on an ongoing activity |
review |
bookworm review <input> |
| Log a review or reflection on completed work |
streak | bookworm streak <input> | Record streak data for daily habit tracking |
remind | bookworm remind <input> | Set a reminder note for follow-up |
prioritize | bookworm prioritize <input> | Mark or log priority items |
archive | bookworm archive <input> | Move completed items to the archive |
tag | bookworm tag <input> | Add tags or labels to organize entries |
timeline | bookworm timeline <input> | Log timeline milestones or events |
report | bookworm report <input> | Generate or log a report entry |
weekly-review | bookworm weekly-review <input> | Perform a weekly review and log insights |
stats | bookworm stats | Show summary statistics across all log files |
export | bookworm export <fmt> | Export all data (json, csv, or txt) |
search | bookworm search <term> | Search across all log files for a keyword |
recent | bookworm recent | Show the 20 most recent history entries |
status | bookworm status | Health check — version, entry count, disk usage |
help | bookworm help | Show the help message with all commands |
version | bookworm version | Print the current version |
All entry commands (add, plan, track, review, streak, remind, prioritize, archive, tag, timeline, report, weekly-review) work the same way:
<command>.log and logs to history.logAll data is stored in ~/.local/share/bookworm/:
add.log, plan.log, track.log, etc. — one log file per commandhistory.log — unified activity log across all commandsexport.json / export.csv / export.txt — generated export filesEach entry is stored as YYYY-MM-DD HH:MM|<value> (pipe-delimited timestamp and content).
set -euo pipefail)date, wc, du, grep, head, tail, catbookworm add "Finished Chapter 5 of Sapiens" to maintain a running log of your reading progress day by day.bookworm streak "Day 15 of reading 30min/day" to record consecutive-day habits and review your consistency over time.bookworm weekly-review "Read 3 books, favorite was Project Hail Mary" at the end of each week to capture insights and progress.bookworm prioritize "Must finish Design Patterns by Friday" to flag high-priority items and review them with bookworm prioritize.bookworm export json to export all your logged data into a structured format for further analysis in spreadsheets or scripts.# Add a book to your reading list
bookworm add "The Pragmatic Programmer - Hunt & Thomas"
# Plan your reading goals for the month
bookworm plan "Read 4 books in March: 2 fiction, 2 non-fiction"
# Track reading progress
bookworm track "Sapiens - Chapter 8/21 complete"
# Log a book review
bookworm review "Clean Code: Excellent guide to writing maintainable software. 5/5"
# Record a reading streak
bookworm streak "Day 30 - read every day this month!"
# Set a reminder
bookworm remind "Return library books by March 25"
# Tag entries for organization
bookworm tag "Sapiens #non-fiction #history #favorite"
# View summary statistics
bookworm stats
# Search for a specific book or keyword
bookworm search "Sapiens"
# Export everything to CSV
bookworm export csv
# Check system status
bookworm status
Data directory: ~/.local/share/bookworm/ (hardcoded, no environment variable override).
All commands print results to stdout. Redirect output to a file if needed:
bookworm stats > my-stats.txt
bookworm export json
Note: This is an original, independent implementation by BytesAgain. Not affiliated with or derived from any third-party project.
Powered by BytesAgain | bytesagain.com | [email protected]