核心功能
ClawPM 是一款面向多项目场景的任务管理 CLI 工具，采用文件系统优先的架构设计：任务以 Markdown 文件形式存储于 ~/.project/ 目录下，通过文件状态（后缀/目录）映射任务状态（open/progress/done/blocked）。这种设计带来天然的可移植性与版本控制友好性。
关键能力：
- 项目自动发现：支持从当前目录向上遍历、git 仓库检测、显式上下文切换（
clawpm use）三种方式定位项目 - 任务管理：完整的 CRUD 操作，支持子任务层级（
--parent/split）、优先级、复杂度标记 - 工作日志：自动记录状态变更与 git 文件变更，支持
tail -f式实时追踪 - Agent 上下文：
clawpm context单命令输出项目全貌——任务状态、进行中的工作、阻塞项、近期日志、git 状态，专为 AI Agent 恢复会话设计
输出设计：默认 JSON 输出便于程序解析，-f text 切换人类可读格式。
显著优点
1. 去中心化存储：不依赖外部数据库或 SaaS，数据完全本地可控，符合隐私敏感场景
2. Agent 原生设计：context 命令和 JSON 输出明显为 LLM/Agent 工作流优化，是少数明确标注 "agent-invoked" 能力的工具
3. git 集成深度：自动检测 git 仓库、记录 commit 到工作日志、文件变更追踪
4. 短 ID 交互：CLAWP-042 可简写为 42，日常操作高效
5. 子任务完整性检查：父任务标记完成前强制验证子任务状态，避免遗漏
局限性与风险
- 无协作机制：纯本地设计，天然不支持团队共享或实时同步
- 无可视化界面：完全 CLI 驱动，非技术用户门槛较高
- 数据备份责任：用户需自行管理
~/clawpm目录的备份策略 - 生态早期：GitHub 仓库较新（截至知识截止），长期维护稳定性待观察
适合人群
- 个人开发者、独立研究员需要跨项目跟踪任务
- AI Agent/LLM 工作流构建者，需要结构化项目上下文注入
- 偏好本地优先、避免 Notion/Jira 等 SaaS 的用户
- 终端重度用户，习惯命令行效率