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

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 \x3Ccommand>.log and logs to history.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 command
• history.log — unified activity log across all commands
• export.json / export.csv / export.txt — generated export files

Each entry is stored as YYYY-MM-DD HH:MM|\x3Cvalue> (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

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 stats

# Search for a specific book or keyword
bookworm search "Sapiens"

# Export everything to CSV
bookworm export csv

# Check 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 | [email protected]