从零开始用 caveman 管理任务一个老程序员为什么放弃一堆待办 App回归一条命令如果你和我一样试过 Notion、Todoist、TickTick甚至自己搭过带数据库的待办系统大概最终都会产生同一个困惑工具越强大维护工具本身花的时间越多。分类、标签、优先级、提醒、协作、跨平台同步……每多一个功能就多一层使用成本。到头来你真正需要的其实只是“把事儿记下来、到时间看一眼、做完划掉”这三件事。后来我在终端里发现了 caveman。它是一个极简主义的任务管理工具核心逻辑非常简单你的待办事项就是一个纯文本文件所有操作通过命令行完成。不需要数据库、不需要 GUI、不需要联网、不需要订阅甚至不需要安装什么重量级依赖。它的名字“caveman”本身就说明了它的定位——像穴居人一样原始的、简单直接的做事方式。这篇博客我想完整拆解一下 caveman 这个项目它的设计思路为什么成立、怎么在本地把它跑起来、日常到底怎么高效使用以及我实测一年后遇到过的各种坑。如果你和我一样是终端重度用户或者被各种花哨的待办工具折腾得足够疲惫这篇文章应该能帮你打开一个全新的思路。1. caveman 的整体设计思路与定位为什么“极简”反而能解决“坚持不下去”的问题1.1 不是功能缺失而是功能聚焦先聊一个很多人会忽略的事实大部分任务管理工具的问题不在于功能太少而在于功能太多。你打开一个待办 App看到的是工作台、看板、日历、统计图表、团队空间……还没开始记录任务光是整理这些界面就已经消耗了精力。caveman 的设计者和我想法类似任务管理的本质不是“管理”而是“记录 回顾”。它把整个系统压缩成了两个核心概念一个纯文本文件存放你所有的任务默认叫 TODO.txt一组简单的 shell 命令用来添加、查看、完成、删除任务没有状态机没有优先级矩阵没有任何后台服务。你输入caveman add 写季度报告这条命令就把任务追加到文本文件里。你输入caveman done 3它就把第三行任务标记为完成。整个过程是直接操作文件而不是操作某种抽象的数据结构。1.2 为什么要用纯文本文件而不是数据库这是我认为 caveman 最聪明的地方。任何数据库方案都意味着你需要维护一套运行环境哪怕只是 SQLite也需要考虑文件路径、锁、迁移、备份恢复等等。但纯文本文件有四个天然优势可读性你可以直接打开 TODO.txt 查看所有任务不需要任何工具。这对“信任感”很重要——你能够看见数据存在哪里、长什么样。可移植性TODO.txt 就是一个普通文件可以放到 Dropbox、Git 仓库、U 盘里随手带走。换电脑时复制粘贴就行。可编程性文本文件天然可以被任何脚本处理grep、sed、awk、Python、Ruby……都可以直接操作这意味着你可以把任务数据和自己的自动化流程无缝结合。可回溯性配合 Git 使用每次添加或完成任务都会形成一次提交历史相当于自带完整的操作日志。1.3 适合哪些人不适合哪些人我得老老实实说caveman 不是面向所有人的工具。它适合终端重度用户日常操作大部分时间在命令行里完成的人任务量适中的个人用户每天任务在几到几十条之间不需要复杂协作喜欢数据主权希望自己的待办数据随时可控、可迁移的人受够了“工具管理”的人不想再花时间维护分类规则、调整视图方式不适合需要复杂项目协作和多人分配任务的团队需要强提醒、日历弹窗、移动端推送的用户完全没接触过命令行的纯小白如果上面“不适合”里的描述戳中了你那 caveman 大概率不适合你可以绕道走了。但如果你和我一样觉得命令行本来就是自己的一部分那这个工具会给你带来意想不到的流畅体验。2. 安装与初始化从零到跑通只需要三步2.1 获取 caveman 脚本caveman 的实现方式很朴素就是一个 bash 脚本。这意味着安装方式也极其简单。项目仓库里提供了install.sh或者你直接把脚本文件下载到本地。最常见的做法是克隆仓库或者单独下载脚本放到一个合适的目录下然后给它可执行权限# 假设你下载到了 ~/bin 目录 chmod x ~/bin/caveman如果你不想手动下载也可以直接用 curl 拉取curl -o ~/bin/caveman https://example.com/caveman # 替换为实际的脚本地址 chmod x ~/bin/caveman安装过程唯一要做的就是确保这个文件可执行并把它所在的目录加入 PATH。我自己习惯把所有命令行小工具集中放在~/bin下所以这一步对我来说几乎是零成本。2.2 设置别名让命令更顺手caveman 的原生命令是完整的但如果你每天要敲很多次完全可以给它设置一个别名。我在.bashrc或者.zshrc里加了一行alias cmcaveman这样我只需要敲cm add 买牛奶、cm list这种短命令效率提升明显。别小看这个改动命令越短使用频率就越高。待办工具最大的敌人是“懒得打开”别名能帮你扫清这个心理障碍。2.3 初始化数据文件caveman 第一次运行时会自动创建 TODO.txt 文件。默认路径通常是当前用户的 home 目录下你可以通过环境变量来指定自定义路径。我个人建议把数据文件放到一个独立目录比如export CAVEMAN_TODO_FILE$HOME/.caveman/todo.txt设置成隐藏目录的好处是眼不见心不烦但数据依然是纯文本随时可以打开查看。初始化完成后整个工具就算是跑起来了没有繁琐的向导没有注册流程就是这么简单直接。3. 核心命令体系日常任务管理的实操全解3.1 任务的新增与批量录入日常使用中我最常用的命令是add。用法很简单caveman add 预约牙医 caveman add 整理发票 2024-06-15注意看第二条命令我在任务内容后面加了一个日期。这是 caveman 的惯用约定支持在任务末尾添加yyyy-MM-dd格式的日期作为截止日期。如果你的任务没有日期它就默认是无期限的普通任务。批量录入场景也很实用。比如从同事发来的一段文字里提取任务我可以先在文本里逐行整理好然后用管道一次性导入cat tasks.txt | while read line; do caveman add $line; done这个操作对很多新人来说可能有点绕但理解了“caveman 本质是文本文件操作”之后你会发现这是最自然的处理方式——任何能输出文本的程序都可以成为你的任务数据源。3.2 查看任务清单基础查看与状态过滤查看任务清单是使用频率最高的操作对应命令是listcaveman list输出结果大致长这样1. [ ] 预约牙医 (2024-06-15) 2. [ ] 整理发票 (2024-06-15) 3. [x] 提交周报每一行前面是序号方括号里是任务状态空格表示未完成x表示已完成。这个格式非常直观——你看一眼就知道有哪些任务没做。如果你想只查看未完成任务或已完成任务可以加参数过滤caveman list --pending caveman list --completed这两个选项在任务量大时特别好用。我每天早上的第一件事就是敲cm list --pending一眼扫过去心里就有数了。注意caveman 默认不会自动隐藏已完成任务所以如果你想要一个干爽的待办界面手动带上--pending参数是比较好的习惯。3.3 任务完成、删除与中断处理完成任务通常就用done命令带上序号caveman done 1这个操作会把第一行任务标记为[x]。如果你完成的是带日期的任务caveman 还会额外记录实际完成日期。删除任务的命令是removecaveman remove 2如果你修改了某个任务的内容可以用edit命令直接打开默认编辑器修改那一行改完后保存即可。有一个小技巧我特别想分享如果任务做到一半发现暂时做不了但又不舍得删掉我会在原任务内容前加上前缀(waiting)或者[暂停]之类的标记再用done把它标记为完成这样在审查历史时仍然能看到它曾经存在过。当然这属于个人习惯caveman 本身很开放不会对你的标记方式指手画脚。3.4 任务日期的灵活处理日期处理是任务管理里最容易混乱的部分caveman 的设计却很扎实。它的基本逻辑是如果任务最后一列是yyyy-MM-dd格式就把它识别为截止日期。查看带日期的任务可以这样caveman list --due最好用的一个功能是查看“今天要做的事”caveman due 2024-06-15它会把所有截止日期为此日期的未完成任务列出来非常适合早上快速规划。如果任务数量多我还习惯用 shell 的管道结合 grep 做自定义过滤比如只看本周待办。这种灵活性是图形化 App 很难给我的。3.5 在真实场景里的组合用法单独看每个命令都很简单但组合起来就是一套完整的工作流。我自己的使用节奏大概是这样的每天早上cm list --pending快速浏览所有未完成任务挑出今天必须处理的 3 件在心里排个序随时接到新任务cm add 给客户回访电话一句话完事绝不给大脑留记忆负担中午检查进度cm due 今天日期看看截止任务是否即将挤压到一起下班前收官把当天完成的任务挨个cm done 序号然后cm list --completed看看今天的战绩这套流程不过五分钟但它给了我非常清晰的掌控感。任务管理工具的终极价值不在于帮你做任务而在于让你知道“自己在什么时候该干什么”。4. 进阶玩法让 caveman 进入你的自动化工作流4.1 把待办事项接入 Git获得完整时间线这是我最推荐的进阶操作之一。既然 TODO.txt 是纯文本我们就能把它放到 Git 仓库里管理。每添加一条任务、每完成一条任务都可以提交一次cd ~/.caveman git init git add todo.txt git commit -m 初始化任务文件之后每次操作完任务追加一条提交说明。长期下来整个文件的历史就变成了一本完整的“个人工作日志”。某一天你突然想回忆上周干了什么直接git log --oneline或者查看某个版本的文件内容即可这种能力在图形化待办工具里几乎不存在。4.2 用 cron 自动生成每日待办待办工具还有一个痛点如果早上打开看的时候没有任务你就不大会再打开它。解决这个问题最笨也最有效的办法就是让系统自动帮你注入一些固定的重复性任务。我写了一个很简单的 cron 定时任务每天早上 8 点执行0 8 * * * echo caveman add 晨会准备 | bash还可以用同样的方式加“复盘当日工作”“给盆栽浇水”等周期性任务。配合 Sunday/Monday 这类固定日期任务我的待办列表从来不会在打开时是空的——这种“预加载”的体验让坚持使用变得容易很多。如果你不想用 cron也可以在 shell 配置里加一个函数登录终端时自动检查当天是否有任务function cm_start() { caveman due $(date %Y-%m-%d) }这个函数会在每次开启新终端时提醒你今天的事项算是一个轻量级的“每日唤起”。4.3 与编辑器协同操作caveman 没有提供复杂的批量编辑界面但它从来没有禁止你直接编辑 TODO.txt。如果你想批量调整一堆任务的顺序、批量修改日期最快的方式不是一条条敲命令而是直接打开文件编辑vim ~/.caveman/todo.txt因为文件格式是通用的行文本格式你完全可以按自己的习惯调整。改完保存后caveman 下次读取时会自动识别最新的状态。这种灵活度来自纯文本的设计决策也是我坚持使用它的核心理由之一——任务工具不该把你锁死在某种交互方式里。5. 常见问题与排查技巧一年多实操中踩过的坑5.1 命令找不到或者不生效怎么办最常见的问题就是系统提示caveman: command not found。这个问题的根源基本都是 PATH 没有配置正确。检查一下你的脚本到底放在哪了以及在.bashrc/.zshrc中是否添加了正确的导出语句export PATH$HOME/bin:$PATH改完配置后记得source ~/.zshrc或者重新登录终端。另外检查脚本是否有可执行权限ls -l ~/bin/caveman如果第一列没有x权限就执行chmod x。这三步基本能解决九成以上的环境问题。5.2 中文乱码和字符显示问题因为 TODO.txt 是纯文本如果终端字符集设置不对中文任务内容可能显示成奇怪的乱码。这通常不是 caveman 的问题而是终端环境的 locale 设置问题。你可以用echo $LANG检查输出是否为UTF-8相关的值比如en_US.UTF-8或zh_CN.UTF-8。如果不是在 shell 配置文件里加上export LANGzh_CN.UTF-8还有一个容易忽略的细节如果某个任务文字特别长list输出可能会挤占终端宽度。这时候要么缩短任务描述要么靠终端自动换行调整。5.3 任务序号不对了怎么办当你在任务列表里删除了某一项剩余任务的序号会自动重新排列。但如果你正在熟记“第3条任务是必须完成的”删除操作会把所有后续任务的序号整体前移如果你这时执行done 4完成的是原来第5条的任务。这不算 bug不过对使用习惯有影响。我的建议是不要死记序号每次操作前都用cm list看一下当前序号。尤其在批量完成时人眼确认一遍比什么都靠谱。如果不想改变原有顺序也可以“软删除”——把任务标记为完成而不是删除这样序号始终保持稳定。5.4 多台电脑间同步时的文件冲突我曾在两台电脑上同时使用 caveman同步方案选择了云存储。结果有一次两边的 TODO.txt 都发生了修改云盘自我冲突生成了一个新的文件导致任务数据一度很混乱。如果你也需要多端同步建议遵循两条原则同一时间尽量只在一台设备上修改任务数据同步前先 pull / 同步后再 push养成固定顺序如果你用 Git 同步那更简单每次修改前先git pull改完再git add、git commit、git push。这条原则虽然简单但能避免绝大多数冲突。5.5 任务一多就眼花怎么办list默认输出所有任务当你的未完成任务超过几十条时输出会变得很长。这时候可以利用 grep 在管道中做筛选。比如我只想看含“家里”的任务caveman list | grep 家里如果想看到任务总数可以用caveman list | grep -c \[ \]这种“命令行工具 管道哲学”的模式让 caveman 的使用深度没有上限——它不限制你只有你能限制自己。6. 工具选型思考caveman 与主流待办工具的对比6.1 它凭什么能取代我手机上的待办应用很多人会质疑一个命令行工具怎么比得上有移动端推送、有日历视图的正经待办应用我承认单论推送提醒和手机端可用性caveman 完败。但我的核心诉求并不是这些。说一个很现实的场景当我在电脑前工作时我经常需要回几条消息、处理几封邮件然后就被各种信息碎片带走忘了原本要做什么。此时如果我需要掏出手机解锁、打开 App、找到任务分类、逐条浏览这种摩擦已经足够让我放弃“记录任务”这个动作了。而 caveman 在终端里就是一条命令的事。顺手的工具才能被频繁使用能用住的工具才是好工具。caveman 最大的优势在于“无摩擦”它把“记录待办”这个动作变成了一种自然反应。6.2 缺失的功能如何补救真要说缺点caveman 也确实有几个明显的短板没有提醒推送只能靠 cron 或外部工具触发通知没有移动端手机上看不了任务列表除非你自己搭同步没有任务分类/标签只能靠文本内容表达或者借助后缀符号之类的习惯没有优先级可视化优先级完全靠你自己在文字层面维护这些短板其实都能用简单方案绕过去。提醒可以靠 cron notify-send 实现移动端可以用 Git 仓库的网页版远程查看标签可以用#xx标记然后 grep。虽然麻烦了一点但我个人觉得这种“系统透明度”带来的掌控感远远超过那些看不见底层逻辑的 App。6.3 我为什么最终留在了 caveman我用过不下十种待办工具最后留在 caveman 的核心理由只有一条它能让我长期保持“记录动作”不中断。很多工具输给用户的不是功能而是加载速度、启动成本、维护成本。而 caveman 通过极简设计把这些成本降到了最低。你可以在没有网络的情况下使用它可以在凌晨三点的黑暗终端里使用它甚至可以在 SSH 到远程服务器时用它来记录服务器运维的临时任务——这些场景里它都是最可靠的。7. 从我自己的使用习惯中提炼的几点建议如果你决定尝试 caveman结合我这一年多的实操有几个建议希望能帮到你第一把任务写清楚而不是写漂亮。不要费心组织语言一句话能让自己看懂就行。待办工具是给自己看的不是给别人审查的。第二每天固定时间看一眼清单。我建议是早上开工前和下班前两个时间点每做一个动作都很轻量但长期坚持能让任务管理真正形成节奏感。第三及时清理完成项。虽然done之后任务还留在清单里但我建议每周五下班前集中执行一次清理直接把已经完成的任务删除让假期前的清单干干净净大脑也会跟着清爽。第四别急着加自定义功能。刚上手时你可能会想给 caveman 加各种 hook、颜色、分类。我建议先用原版跑两周当你真正理解了你需要什么功能、哪些是伪需求之后再动手扩展。过早地“增强”是新手最容易犯的错误。8. 写在最后的个人体会工具这个东西有时候不是越多越好而是越顺手越好。caveman 没有惊艳的界面、没有时髦的 AI 推荐、没有任何可以炫耀的高级特性它只是一个埋藏在终端里的小脚本。但恰恰是这种“原始”的感觉让我把任务管理坚持了下来。我回头看这一年多的工作记录时那些git log里的提交历史清晰地见证了我每一天的付出和收获这种感觉是任何数据看板都给不了的。如果你也被各种花哨的生产力工具折磨过不妨试试这个“穴居人”式的解决方案。也许你会发现少即是多慢即是快一条命令就能让你找回掌控工作的朴素感觉。最后一个小提示别忘了备份你的 TODO.txt——毕竟这文件里的内容是你真实生活的一部分。