planning-with-files
面向 AI 编码 Agent 和长时间运行任务的持久化文件规划与上下文恢复
仍在活跃开发：最近 90 天有 237 次提交，最近一次提交在 2026-09-27。
GitHub 星数
2.7 万
近 30 天涨星
+660
近 90 天提交
237
近 6 个月发版
10
一种在磁盘上为 AI 编码 Agent 维护 task_plan.md、findings.md 和 progress.md 文件的技能。它通过生命周期钩子在每一轮重新注入规划上下文，提供在上下文丢失、执行 /clear 命令、崩溃和上下文压缩后仍能保留的持久化规划。它通过 Agent Skills 标准支持在 60+ 种 Agent 中安装，并为 Claude Code、Codex CLI 和其他平台提供原生插件。
和同类工具的区别
基于文件的规划持久保存在磁盘上，并在每一轮重新注入，不同于依赖上下文窗口、会随记忆重置而消失的待办列表。
主要能力
- 基于文件的持久化规划
- 在执行 /clear 和崩溃后恢复会话
- 每轮重新注入上下文
- 确定性的完成检查关卡
- 多 Agent 支持
- 并行任务隔离
适合
- 长时间运行的 AI 编码 Agent 任务
- 需要崩溃恢复的项目
- 跨会话保留规划上下文
- 多 Agent 协调
不太适合
- 面向最终用户的 AI 应用
- 非编码 Agent 工作流
- 简单的一次性任务
局限
- 读取同一项目的本地 Agent 会话记录需要显式启用 catchup 模式
- 基于文件的方式可能不适合所有工作流偏好
planning-with-files 的替代品
- Claude-Mem：捕获并压缩 Agent 活动，为不同编码会话提供相关上下文（9.5 万星）
- memvid（1.7 万星）
- memU（1.4 万星）
- Context Mode：在沙箱中隔离工具输出、持久化会话记忆并跨平台强制执行路由的 MCP 服务器（2.5 万星）
- claude-context（1.3 万星）
- code-review-graph：通过 MCP 向 AI 编码工具提供精简审查上下文的本地代码知识图谱（3.2 万星）
常见问题
- planning-with-files 是做什么的？
- 一种在磁盘上为 AI 编码 Agent 维护 task_plan.md、findings.md 和 progress.md 文件的技能。它通过生命周期钩子在每一轮重新注入规划上下文，提供在上下文丢失、执行 /clear 命令、崩溃和上下文压缩后仍能保留的持久化规划。它通过 Agent Skills 标准支持在 60+ 种 Agent 中安装，并为 Claude Code、Codex CLI 和其他平台提供原生插件。
- planning-with-files 还在维护吗？
- 仍在活跃开发：最近 90 天有 237 次提交，最近一次提交在 2026-09-27。
- planning-with-files 有哪些替代品？
- 和 planning-with-files 最接近的开源替代品有 Claude-Mem、memvid、memU、Context Mode、claude-context、code-review-graph。
- planning-with-files 是开源的吗？
- 是的，planning-with-files 是开源项目，代码托管在 GitHub 上。
星数、提交和发版数据来自 GitHub API，每天自动刷新。介绍文字由 AI 从英文翻译，并经过第二个模型的回译校对。 项目地址：github.com/OthmanAdi/planning-with-files