Description
Planning with Files is a tool designed to facilitate persistent file-based planning for AI coding agents and long-running tasks. It is particularly useful for developers who need to manage complex projects that require continuous updates and adjustments. The tool provides crash-proof markdown plans, ensuring that even if a session is interrupted, the plans remain intact and can be recovered. This is achieved through session recovery features that activate after a /clear command or during compaction processes.
Read More
One of the key features of Planning with Files is its ability to re-inject plans per turn, which helps prevent context rot—a common issue in long-running tasks where the context can become outdated or irrelevant. This ensures that the planning remains relevant and accurate throughout the task's lifecycle. Additionally, the tool offers a deterministic completion gate, which provides a clear endpoint for tasks, helping developers manage their workflows more effectively.
The tool is available for installation from npm, the Claude Code plugin marketplace, or via npx skills, making it accessible to a wide range of users. It supports integration with various platforms, including Codex, Cursor, and OpenCode, and is compatible with over 60 agents, enhancing its versatility and applicability in different coding environments.
Planning with Files is particularly beneficial for developers working on AI projects that require meticulous planning and execution. Its robust features ensure that plans are not only created but also maintained and updated as needed, providing a reliable framework for managing complex coding tasks.
- CategoryAI Coding Assistants
- Pricing ModelOpen source
- DeploymentCloud
- PlatformsWeb
Planning with Files's Core Features
Persistent file-based planning
Crash-proof markdown plans
Session recovery after /clear
Per-turn re-injection against context rot
Deterministic completion gate
Integration with Codex, Cursor, OpenCode
Support for over 60 agents
Available on npm and Claude Code marketplace
Getting Started with Planning with Files
Clone: Download the repository from GitHub
Install dependencies: Use npm or npx to install
Configure: Set up the tool according to your project needs
Execute: Run the tool to start planning
Optimize: Adjust settings for better performance
Planning with Files's Use Cases
- AI Project Management
- Long-Running Tasks
- Session Recovery
- Context Rot Prevention
- Deterministic Task Completion








