Skip to content
Agent skills

Planning with Files

A planning skill that keeps an agent's plan on disk so it survives context resets.

Repository updated

27k starsMITPythonSelf-hostedUpdated

GitHub metadata checked October 12, 2026. Counts and activity may have changed.

At a glance

Unverified

People running long agent tasks that outlast one context window.

Watch out. It writes planning files into your project. Decide whether to commit them or add them to .gitignore.

Run
Self-host only
Effort
Easy
Deploy
npx skills
License
MIT
Activity
Active · today
Stars Δ
+21

Overview

Planning with Files keeps task_plan.md, findings.md and progress.md in your project and re-injects the plan each turn, so a long task can resume after the context window is cleared.

What it does

  • Plan, findings and progress files on disk
  • Plan re-injected every turn
  • Resumes after /clear or compaction
  • Isolated plans for parallel tasks

Capability source: Project documentation

Who Planning with Files fits

People running long agent tasks that outlast one context window.

How you run it

Planning with Files runs on infrastructure you manage.

Documented deployment options: npx skills.

Python projects · MIT projects · Agent skills

Before you choose it

It writes planning files into your project. Decide whether to commit them or add them to .gitignore.

Self-hosting and deployment

Self-hostable
Yes
Cloud / hosted offering
Not recorded
Docker noted in deployment tags
Not recorded
Deployment tags
npx skills
Difficulty
Easy

Planning with Files questions

What is Planning with Files?
A planning skill that keeps an agent's plan on disk so it survives context resets. It is listed under Agent skills on PickOpenSource.
Is Planning with Files open source?
Yes. Its source code is public on GitHub under the MIT license.
Can you self-host Planning with Files?
Yes. Listed deployment options: npx skills.
Is Planning with Files free?
Pricing is not recorded in this catalog. Check the official website for hosted plans and edition limits, and the MIT license for usage conditions. Self-hosting also requires infrastructure and maintenance.
What are alternatives to Planning with Files?
Similar agent skills projects include Superpowers, Skills by Matt Pocock, and Ponytail.
Is Planning with Files actively maintained?
The latest commit on GitHub was October 12, 2026, and the repository has 27k stars (up 21 since October 11, 2026).

Related projects

Other approved projects in Agent skills: Superpowers, Skills by Matt Pocock, Ponytail.

Maintain Planning with Files? Add the README badge

Listed on PickOpenSource
[![Listed on PickOpenSource](https://pickopensource.site/api/badge/planning-with-files)](https://pickopensource.site/project/planning-with-files)

Claim this listing to edit its profile, add a screenshot, and see listing analytics.