Bookshelf

A personal productivity toolkit for managing books, reading plans, progress tracking, reviews, and reading habits — all from the command line with timestamped local logging, tagging, archiving, and weekly review workflows.

Commands

Each command (add, plan, track, etc.) works the same way:

• - With arguments: saves the entry with a timestamp to its dedicated .log file and records it in activity history
• Without arguments: displays the 20 most recent entries from that command's log

Data Storage

All data is stored locally in plain-text log files:

CODEBLOCK0

Each entry is stored as YYYY-MM-DD HH:MM|<value> for easy parsing and export.

Requirements

• - Bash 4.0+ (uses set -euo pipefail)
• Standard UNIX utilities: date, wc, du, grep, head, tail, INLINECODE28
• No external dependencies or API keys required
• Works offline — all data stays on your machine

When to Use

1. 1. Reading list management — Use add to build your to-read list, prioritize what to pick up next, and archive books once finished or dropped
2. Reading habit tracking — Track daily pages or chapters with track, maintain reading streaks with streak, and review progress in INLINECODE34
3. Book review journaling — After finishing a book, use review to log your thoughts, ratings, and key takeaways for future reference
4. Annual reading goals — Set yearly targets with plan, track progress with stats, and generate periodic reports with report to stay on pace
5. Genre and tag organization — Use tag to categorize books by genre, topic, or mood, then search to find the right book for any occasion

Examples

Add books and start reading

CODEBLOCK1

Track reading progress

CODEBLOCK2

Review, report, and archive

CODEBLOCK3

Search and export

CODEBLOCK4

Output

All commands print confirmation to stdout. Data is persisted in ~/.local/share/bookshelf/. Use bookshelf stats for an overview, bookshelf search <term> to find specific entries, or bookshelf export <fmt> to extract all data as JSON, CSV, or plain text.