Progress will not be saved. This browser is blocking storage (often private browsing). You can still learn, but closing the tab loses your progress.
OthmanAdi/planning-with-files
Persistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60+ agents.
- Stars
- 28,178
- +7 days
- —
- Forks
- 2,323
- Language
- Shell
- License
- MIT
- Last push
- 21 Nov 2026
Summary
Summary written by AI from the README; it may be imprecise.This tool provides persistent file-based planning for AI coding agents across long-running tasks. It maintains three Markdown files—task_plan.md, findings.md, and progress.md—on disk to track tasks, decisions, and session logs. Lifecycle hooks re-inject the plan on every turn, allowing the agent to recover progress after compaction or /clear commands.
Use it when
- When running long coding agent tasks that risk context rot, compaction, or crashes
- When recovering agent progress and task status after using /clear in a session
- Track multi-phase implementation plans and research notes directly on disk across turns
Install
/plugin marketplace add OthmanAdi/planning-with-files/plugin install planning-with-files@planning-with-filesnpx skills add OthmanAdi/planning-with-files --skill planning-with-files -gCommands quoted from the repo's README. Read the README before running them.
Includes hooks that run shell commands on your machine. Read them before installing.
Stars over 90 days
Collecting: 2 of 90 days so far. The chart appears after 7 days.