- version
- 2.0.0
- name
- bookworm
- description
- Log books, track reading habits, and review reading streaks over time. Use when recording reads, maintaining goals, or analyzing genre preferences.
- author
- BytesAgain
- homepage
- https://bytesagain.com
- source
- https://github.com/bytesagain/ai-skills
Bookworm
Bookworm v2.0.0 — a productivity toolkit for logging, planning, tracking, reviewing, and organizing your work and reading habits from the command line.
Why Bookworm?
- Designed for everyday personal productivity use
- No external dependencies, accounts, or API keys needed — your privacy, your data
- Simple commands with powerful results
- All data stored locally in plain-text log files
- Export to JSON, CSV, or TXT at any time
Commands
| 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:
- With arguments: saves a timestamped entry to
<command>.logand logs tohistory.log - Without arguments: displays the 20 most recent entries from that command's log
Data Storage
All 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 files
Each entry is stored as YYYY-MM-DD HH:MM|<value> (pipe-delimited timestamp and content).
Requirements
- Bash (with
set -euo pipefail) - Standard Unix utilities:
date,wc,du,grep,head,tail,cat - No external dependencies, no Python, no API keys
When to Use
- Daily reading log — Use
bookworm add "Finished Chapter 5 of Sapiens"to maintain a running log of your reading progress day by day. - Habit streak tracking — Use
bookworm streak "Day 15 of reading 30min/day"to record consecutive-day habits and review your consistency over time. - Weekly reflection — Use
bookworm weekly-review "Read 3 books, favorite was Project Hail Mary"at the end of each week to capture insights and progress. - Priority management — Use
bookworm prioritize "Must finish Design Patterns by Friday"to flag high-priority items and review them withbookworm prioritize. - Data export for analysis — Use
bookworm export jsonto export all your logged data into a structured format for further analysis in spreadsheets or scripts.
Examples
# 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 statusConfiguration
Data directory: ~/.local/share/bookworm/ (hardcoded, no environment variable override).
Output
All commands print results to stdout. Redirect output to a file if needed:
bookworm stats > my-stats.txt
bookworm export jsonNote: This is an original, independent implementation by BytesAgain. Not affiliated with or derived from any third-party project.
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com