ClawKeeper — Tasks & habits in a plain markdown file

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

任务和习惯存放在本地纯文本 Markdown 文件中，免费、私密、原生支持。

Clawkeeper CMI. 通过 Clawkeeper CMI 管理用户的任务和习惯

功能概述

Clawkeeper CMI. 通过 Clawkeeper CMI 管理用户的任务和习惯是一项面向实际任务的技能，主要用于所有数据都存储在 CLAWKEEPER DIR 设置的路径上( 默认为 ~/.clawkeeper/ )；如果 CLAWKEPER DIR 是本身。

核心要点

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

结果检查与注意事项

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

ClawKeeper CLI

通过 ClawKeeper CLI 管理用户的任务与习惯。所有数据均以 Markdown 格式存储在 CLAWKEEPER_DIR 指定的路径下（默认为 ~/.clawkeeper/）。

clawkeeper   [--flags]

若环境变量中设置了 CLAWKEEPER_DIR，CLI 将从此路径读取和写入数据。这使得多个 agent 可共享同一份任务列表。

任务

clawkeeper task list
clawkeeper task add --text "Buy groceries"
clawkeeper task add --text "Buy groceries" --due-date 2026-03-15
clawkeeper task add-subtask --parent-text "Buy groceries" --text "Milk"
clawkeeper task complete --id 
clawkeeper task complete --text "Buy groceries"
clawkeeper task uncomplete --id 
clawkeeper task edit --text "Old name" --new-text "New name"
clawkeeper task edit --text "Old name" --due-date 2026-04-01
clawkeeper task set-due-date --text "Buy groceries" --due-date 2026-03-15
clawkeeper task set-due-date --text "Buy groceries" --due-date none
clawkeeper task delete --text "Buy groceries"
clawkeeper task add-note --text "Buy groceries" --note "Check prices first"
clawkeeper task edit-note --text "Buy groceries" --note "Check prices first" --new-note "Compare at two stores"
clawkeeper task delete-note --text "Buy groceries" --note "Check prices first"

习惯

clawkeeper habit list
clawkeeper habit add --text "Meditate" --interval 24
clawkeeper habit edit --text "Meditate" --new-text "Morning meditation" --interval 12
clawkeeper habit delete --text "Meditate"
clawkeeper habit complete --text "Meditate"
clawkeeper habit add-note --text "Meditate" --note "Felt calm today"
clawkeeper habit edit-note --text "Meditate" --note "Felt calm today" --new-note "Felt calm, 10 min session"
clawkeeper habit delete-note --text "Meditate" --note "Felt calm today"

状态

clawkeeper state show

主动检查（心跳机制）

执行周期性检查时，请使用 clawkeeper state show 查看用户的习惯与任务状态：

遗漏的习惯：若某习惯未完成时间已超过其设定间隔的两倍，请以温和方式询问。人们会遗忘——一次轻柔提醒远胜于说教。
连续完成趋势：当某习惯的完成次数持续上升时，可简要肯定当前进展势头。
近期笔记：若用户最近添加了反思或备注，请在对话中适当引用，以保持上下文连贯性。这表明你确实在关注用户动态。
陈旧任务：长期处于“待办”状态的任务，可能需要拆解、重新排序优先级，或直接移除。

语气应体现支持性协作者姿态，而非严厉教官。若无任何需关注事项，请回复 HEARTBEAT_OK。

注意事项

所有命令均返回 JSON 格式结果：成功时为 {"ok": true, "data": ...}；失败时为 {"ok": false, "error": "..."}。
ID 在多次调用中保持稳定。如需精确匹配请使用 --id，如需模糊子串匹配则使用 --text。
添加任务后，响应中将包含该新任务的 id，可用于后续操作。