planning-with-files

把 AI 计划存成文件,崩溃/清空后也能接着干

planning-with-files 是一个基于文件系统的持久化规划工具,专为 AI 编程代理和长时间运行的任务设计。它解决了 AI 代理在对话中断、上下文压缩或模型重置后丢失计划的问题,通过将计划以 Markdown 文件形式持久化存储,实现崩溃恢复和会话恢复。其核心能力包括:每轮自动将计划重新注入上下文,对抗上下文衰减(context rot);提供确定性的完成门控,确保任务按计划推进;支持多种主流 AI 代理(如 Claude Code、Codex、Cursor、OpenCode 等 60+ 工具)。安装方式多样,可通过 npm、Claude Code 插件市场或 npx skills 获取。该项目采用 Shell 语言编写,轻量且易于集成,适合需要长期稳定执行复杂任务的 AI 工作流。

开源 free 智能体
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 27071
维护状态 活跃
是否开源 是
定价模式 free

项目数据

分类智能体
开发团队OthmanAdi
所属国家
定价模式free
价格说明开源项目,MIT 许可证,完全免费,可自行部署使用。
访问状态
是否开源是
开源协议MIT
主要语言Shell
技术栈/模型agent-skills,autonomous-agents,claude,claude-code,claude-code-skills,claude-skills,codex,coding-agent,context-engineering,context-rot,cursor,github-copilot,hermes-plugin,hermes-skill,llm-agents,long-running-agents,manus,multi-agent-systems,planning,session-recovery
GitHub 星标★ 27071
30天Star增速
HF 下载量
上线时间2026-01-03 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数3

使用教程

核心亮点

  • 计划持久化到 Markdown,/clear 或上下文压缩后不丢失,可无缝恢复
  • 每轮自动重注入计划,有效缓解长任务中的上下文衰减问题
  • 兼容 60+ AI 代理,安装简单(npm/插件市场/npx),生态覆盖广

不足之处

  • 依赖文件系统,多代理协作时需自行处理文件同步冲突
  • 文档/社区待观察

适用场景

  • 长时间运行的 AI 编码任务,需跨会话保持计划
  • 使用 Claude Code 等代理时,防止上下文压缩导致计划丢失
  • 多代理协作场景,通过共享计划文件协调进度

替代项目

Claude Code 内置 Tasks、Aider、OpenHands

项目介绍

planning-with-files 是智能体领域的开源项目,由 OthmanAdi 开发,是 2026 年新上线的项目。

在全站 13,090 个收录项目中,它的 GitHub 星标数(27,071)位列前 2%,在智能体分类的 2,517 个项目里位列前 3%。

近 41 天,它的 GitHub 星标从 26,128 增加到 27,071,净增 943。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。MIT 许可证,完全免费,可自行部署使用。

它主要面向的使用场景是:长时间运行的AI编码任务,需跨会话保持计划。同类可对比的替代方案包括 Claude Code 内置 Tasks、Aider、OpenHands。

上一篇:swarm-foraging-qlearn

下一篇:Adala

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 199 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12