Bookworm
by @ckchzh
Log books, track reading habits, and review reading streaks over time. Use when recording reads, maintaining goals, or analyzing genre preferences.
clawhub install bookwormπ About This Skill
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?
Commands
| Command | Usage | Description |
|---------|-------|-------------|
| add | bookworm add | Add a new entry (book, task, note) to your log |
| plan | bookworm plan | Record a plan or goal for future action |
| track | bookworm track | Track progress on an ongoing activity |
| review | bookworm review | Log a review or reflection on completed work |
| streak | bookworm streak | Record streak data for daily habit tracking |
| remind | bookworm remind | Set a reminder note for follow-up |
| prioritize | bookworm prioritize | Mark or log priority items |
| archive | bookworm archive | Move completed items to the archive |
| tag | bookworm tag | Add tags or labels to organize entries |
| timeline | bookworm timeline | Log timeline milestones or events |
| report | bookworm report | Generate or log a report entry |
| weekly-review | bookworm weekly-review | Perform a weekly review and log insights |
| stats | bookworm stats | Show summary statistics across all log files |
| export | bookworm export | Export all data (json, csv, or txt) |
| search | bookworm search | 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:
.log and logs to history.logData 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 filesEach entry is stored as YYYY-MM-DD HH:MM| (pipe-delimited timestamp and content).
Requirements
set -euo pipefail)date, wc, du, grep, head, tail, catWhen to Use
1. Daily reading log β Use bookworm add "Finished Chapter 5 of Sapiens" to maintain a running log of your reading progress day by day.
2. Habit streak tracking β Use bookworm streak "Day 15 of reading 30min/day" to record consecutive-day habits and review your consistency over time.
3. 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.
4. Priority management β Use bookworm prioritize "Must finish Design Patterns by Friday" to flag high-priority items and review them with bookworm prioritize.
5. Data export for analysis β Use bookworm export json to 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 statsSearch for a specific book or keyword
bookworm search "Sapiens"Export everything to CSV
bookworm export csvCheck system status
bookworm status
Configuration
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 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 | hello@bytesagain.com
β‘ When to Use
π‘ 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 statsSearch for a specific book or keyword
bookworm search "Sapiens"Export everything to CSV
bookworm export csvCheck system status
bookworm status
βοΈ Configuration
Data directory: ~/.local/share/bookworm/ (hardcoded, no environment variable override).