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 |
|---|
| INLINECODE0 | INLINECODE1 | Add a new entry (book, task, note) to your log |
| INLINECODE2 |
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>.log and logs to INLINECODE39 - 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 - INLINECODE44 — unified activity log across all commands
- INLINECODE45 /
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, INLINECODE56 - 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. - 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 with bookworm prioritize. - 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
CODEBLOCK0
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:
CODEBLOCK1
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
Bookworm
Bookworm v2.0.0 — 一款用于在命令行中记录、规划、追踪、回顾和组织工作与阅读习惯的生产力工具包。
为什么选择 Bookworm？
- - 专为日常个人生产力使用而设计
- 无需外部依赖、账户或 API 密钥——你的隐私，你的数据
- 简单命令，强大效果
- 所有数据本地存储于纯文本日志文件中
- 随时导出为 JSON、CSV 或 TXT 格式
命令
| 命令 | 用法 | 描述 |
|---|
| add | bookworm add <输入> | 向日志中添加新条目（书籍、任务、笔记） |
| plan |
bookworm plan <输入> | 记录未来行动的计划或目标 |
| track | bookworm track <输入> | 追踪正在进行的活动进度 |
| review | bookworm review <输入> | 记录对已完成工作的回顾或反思 |
| streak | bookworm streak <输入> | 记录每日习惯追踪的连续数据 |
| remind | bookworm remind <输入> | 设置跟进提醒笔记 |
| prioritize | bookworm prioritize <输入> | 标记或记录优先级事项 |
| archive | bookworm archive <输入> | 将已完成项目移至归档 |
| tag | bookworm tag <输入> | 添加标签或分类以组织条目 |
| timeline | bookworm timeline <输入> | 记录时间线里程碑或事件 |
| report | bookworm report <输入> | 生成或记录报告条目 |
| weekly-review | bookworm weekly-review <输入> | 执行每周回顾并记录见解 |
| stats | bookworm stats | 显示所有日志文件的汇总统计信息 |
| export | bookworm export <格式> | 导出所有数据（json、csv 或 txt） |
| search | bookworm search <关键词> | 在所有日志文件中搜索关键词 |
| recent | bookworm recent | 显示最近 20 条历史记录 |
| status | bookworm status | 健康检查——版本、条目数、磁盘使用情况 |
| help | bookworm help | 显示包含所有命令的帮助信息 |
| version | bookworm version | 打印当前版本 |
所有条目命令（add、plan、track、review、streak、remind、prioritize、archive、tag、timeline、report、weekly-review）的工作方式相同：
- - 带参数：将带时间戳的条目保存到 <命令>.log 并记录到 history.log
- 不带参数：显示该命令日志中最近的 20 条记录
数据存储
所有数据存储在 ~/.local/share/bookworm/ 中：
- - add.log、plan.log、track.log 等——每个命令一个日志文件
- history.log——所有命令的统一活动日志
- export.json / export.csv / export.txt——生成的导出文件
每个条目存储为 YYYY-MM-DD HH:MM|<值>（管道分隔的时间戳和内容）。
系统要求
- - Bash（使用 set -euo pipefail）
- 标准 Unix 工具：date、wc、du、grep、head、tail、cat
- 无外部依赖，无需 Python，无需 API 密钥
使用场景
- 1. 每日阅读日志——使用 bookworm add 完成《人类简史》第五章 来维护每日阅读进度的连续日志。
- 习惯连续追踪——使用 bookworm streak 每日阅读30分钟的第15天 来记录连续天数习惯并回顾你的坚持情况。
- 每周反思——每周结束时使用 bookworm weekly-review 读了3本书，最喜欢《火星救援》 来捕捉见解和进展。
- 优先级管理——使用 bookworm prioritize 必须在周五前完成《设计模式》 来标记高优先级事项，并通过 bookworm prioritize 进行回顾。
- 数据导出分析——使用 bookworm export json 将所有记录数据导出为结构化格式，以便在电子表格或脚本中进一步分析。
示例
bash
将书籍添加到阅读列表
bookworm add 《程序员修炼之道》- Hunt & Thomas
规划本月的阅读目标
bookworm plan 三月读4本书：2本小说，2本非虚构
追踪阅读进度
bookworm track 《人类简史》- 已完成第8/21章
记录书评
bookworm review 《代码整洁之道》：编写可维护软件的优秀指南。5/5
记录阅读连续天数
bookworm streak 第30天 - 本月每天都阅读！
设置提醒
bookworm remind 3月25日前归还图书馆书籍
为条目添加标签以便组织
bookworm tag 《人类简史》#非虚构 #历史 #最爱
查看汇总统计
bookworm stats
搜索特定书籍或关键词
bookworm search 人类简史
导出所有数据为 CSV
bookworm export csv
检查系统状态
bookworm status
配置
数据目录：~/.local/share/bookworm/（硬编码，不支持环境变量覆盖）。
输出
所有命令将结果打印到标准输出。如有需要，可将输出重定向到文件：
bash
bookworm stats > my-stats.txt
bookworm export json
注意：这是 BytesAgain 的原创独立实现。不与任何第三方项目关联或衍生。
由 BytesAgain 提供支持 | bytesagain.com | hello@bytesagain.com
