Overview
Planning With Files is an open-source workflow skill for Claude Code, Cursor, Codex, GitHub Copilot, and OpenCode, published by OthmanAdi. Its author describes it as: “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…”. The project has 26k stars on GitHub and is available under the MIT license. Add it to your setup with `/plugin marketplace add OthmanAdi/planning-with-files`.
Installation
Add Planning With Files to your agent with:
/plugin marketplace add OthmanAdi/planning-with-filesReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — named in the skill.md
- Codex — named in the skill.md
- Cursor — named in the skill.md
- OpenCode — named in the skill.md
- GitHub Copilot — named in the skill.md
License
Planning With Files is published under the MIT license.
Strengths
- Clear MIT license — safe to read and adapt within its terms
- Ships in OthmanAdi/planning-with-files, an established project with 25,850 GitHub stars
- Works with Claude Code, Codex, Cursor, OpenCode, GitHub Copilot
- Actively maintained — repository updated in the last 90 days
Author
Topics
Frequently asked questions
- What does Planning With Files do?
- 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. Claude Code, Codex, Cursor, Kiro, OpenCode and 60+ agents via the Agent Skills standard.
- How do I install Planning With Files?
- Run /plugin marketplace add OthmanAdi/planning-with-files in your agent, then reload your skills. Review the source at https://github.com/OthmanAdi/planning-with-files before installing.
- Is Planning With Files free to use?
- Yes. Planning With Files is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.
- Which agents does Planning With Files work with?
- Planning With Files lists Claude Code, Codex, Cursor, OpenCode, and GitHub Copilot — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does Planning With Files come from?
- Planning With Files ships inside OthmanAdi/planning-with-files, a repository that contains 8 catalogued skills in total. The repository's 25,850 GitHub stars apply to that whole collection, not to this skill on its own.