FitLog — Productivity Toolkit
FitLog is a command-line productivity toolkit for adding tasks, planning activities, tracking progress, reviewing work, maintaining streaks, setting reminders, prioritizing items, archiving entries, tagging content, viewing timelines, generating reports, and conducting weekly reviews — all with full timestamped history.
Commands
| Command | Description |
|---|
| INLINECODE0 | Add a new entry to the add log |
| INLINECODE1 |
Record a planning entry |
|
fitlog track <input> | Log a tracking entry |
|
fitlog review <input> | Record a review note |
|
fitlog streak <input> | Log a streak milestone or check |
|
fitlog remind <input> | Set or record a reminder |
|
fitlog prioritize <input> | Log a prioritization decision |
|
fitlog archive <input> | Archive an entry |
|
fitlog tag <input> | Tag an entry with a label |
|
fitlog timeline <input> | Record a timeline event |
|
fitlog report <input> | Log a report entry |
|
fitlog weekly-review <input> | Record a weekly review summary |
|
fitlog stats | Show summary statistics across all log files |
|
fitlog search <term> | Search all logs for a keyword |
|
fitlog recent | Show the 20 most recent history entries |
|
fitlog export json\|csv\|txt | Export all data in JSON, CSV, or plain text format |
|
fitlog status | Health check — version, disk usage, entry count, last activity |
|
fitlog help | Show available commands |
|
fitlog version | Print version string (
fitlog v2.0.0) |
Each primary command (add, plan, track, review, etc.) works in two modes:
- - With arguments: Saves the input with a timestamp to its dedicated
.log file and prints a confirmation with the running total - Without arguments: Displays the 20 most recent entries from that command's log
Data Storage
All data is stored in ~/.local/share/fitlog/:
- - Per-command logs:
add.log, plan.log, track.log, review.log, streak.log, remind.log, prioritize.log, archive.log, tag.log, timeline.log, report.log, INLINECODE33 - History log:
history.log — unified activity log across all commands - Export files:
export.json, export.csv, or export.txt when using the bulk export feature
Each log entry is stored as YYYY-MM-DD HH:MM|<value> (pipe-delimited).
Requirements
- - Bash 4+
- No external dependencies or API keys required
- Standard POSIX utilities (
wc, du, grep, tail, head, date)
When to Use
- 1. Daily task tracking — Use
fitlog add and fitlog track to log tasks and activities throughout the day, building a timestamped record of everything you accomplish - Planning and prioritization — Use
fitlog plan and fitlog prioritize to record plans and priority decisions, keeping a clear audit trail of what was planned vs. what was done - Building consistency streaks — Use
fitlog streak to log daily check-ins and milestone completions, helping you maintain productive habits over time - Weekly reviews — Use
fitlog weekly-review to summarize each week's progress, then fitlog stats to see aggregate numbers across all commands - Archiving and organizing — Use
fitlog tag and fitlog archive to categorize and archive entries, keeping your active logs clean while preserving historical data
Examples
CODEBLOCK0
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
FitLog — 生产力工具包
FitLog 是一款命令行生产力工具包,可用于添加任务、规划活动、跟踪进度、审查工作、保持连续记录、设置提醒、确定优先级、归档条目、标记内容、查看时间线、生成报告以及进行每周回顾——所有操作均带有完整的时间戳历史记录。
命令
| 命令 | 描述 |
|---|
| fitlog add <输入> | 向添加日志中添加新条目 |
| fitlog plan <输入> |
记录一条规划条目 |
| fitlog track <输入> | 记录一条跟踪条目 |
| fitlog review <输入> | 记录一条审查备注 |
| fitlog streak <输入> | 记录连续里程碑或签到 |
| fitlog remind <输入> | 设置或记录一条提醒 |
| fitlog prioritize <输入> | 记录优先级决策 |
| fitlog archive <输入> | 归档一条条目 |
| fitlog tag <输入> | 为条目添加标签 |
| fitlog timeline <输入> | 记录时间线事件 |
| fitlog report <输入> | 记录报告条目 |
| fitlog weekly-review <输入> | 记录每周回顾摘要 |
| fitlog stats | 显示所有日志文件的汇总统计信息 |
| fitlog search <关键词> | 在所有日志中搜索关键词 |
| fitlog recent | 显示最近20条历史记录 |
| fitlog export json\|csv\|txt | 以JSON、CSV或纯文本格式导出所有数据 |
| fitlog status | 健康检查——版本、磁盘使用量、条目数、最近活动 |
| fitlog help | 显示可用命令 |
| fitlog version | 打印版本字符串(fitlog v2.0.0) |
每个主要命令(add、plan、track、review等)有两种工作模式:
- - 带参数:将输入内容连同时间戳保存到专用的.log文件中,并显示确认信息及累计总数
- 不带参数:显示该命令日志中最近的20条记录
数据存储
所有数据存储在~/.local/share/fitlog/目录中:
- - 按命令分类的日志:add.log、plan.log、track.log、review.log、streak.log、remind.log、prioritize.log、archive.log、tag.log、timeline.log、report.log、weekly-review.log
- 历史日志:history.log——所有命令的统一活动日志
- 导出文件:使用批量导出功能时生成的export.json、export.csv或export.txt
每条日志条目存储格式为YYYY-MM-DD HH:MM|值(以竖线分隔)。
系统要求
- - Bash 4+
- 无需外部依赖或API密钥
- 标准POSIX工具(wc、du、grep、tail、head、date)
使用场景
- 1. 日常任务跟踪——使用fitlog add和fitlog track记录全天任务和活动,建立带时间戳的完成记录
- 规划与优先级管理——使用fitlog plan和fitlog prioritize记录计划和优先级决策,清晰追踪计划与实际完成情况的差异
- 建立连续习惯——使用fitlog streak记录每日签到和里程碑完成情况,帮助长期保持高效习惯
- 每周回顾——使用fitlog weekly-review总结每周进展,然后通过fitlog stats查看所有命令的汇总数据
- 归档与整理——使用fitlog tag和fitlog archive对条目进行分类和归档,在保留历史数据的同时保持活动日志的整洁
示例
bash
添加新任务
fitlog add 完成季度报告草稿
规划明天的优先级
fitlog plan 上午:代码审查,下午:部署v2.1,晚上:文档
跟踪已完成事项
fitlog track 已部署staging构建#247——所有测试通过
记录连续里程碑
fitlog streak 每日日记第30天
设置提醒
fitlog remind 明天上午10点团队站会
为条目添加标签
fitlog tag project-alpha milestone-3 已完成
生成每周回顾
fitlog weekly-review 发布3个功能,修复12个bug,2个PR待处理
查看最近活动
fitlog recent
以JSON格式导出所有数据
fitlog export json
搜索关键词
fitlog search deploy
检查系统状态
fitlog status
由BytesAgain提供 | bytesagain.com | hello@bytesagain.com