- planningwithfilesselect selects or clears a conversation's plan, including a plan in another project. Successful named initialization also selects its new plan.
- Reading a named taskplan.md selects it only for an unbound conversation. Successful writes and patches can switch to one unambiguous plan; failures, reference reads and patches spanning several…
- Profile-local records survive backend restarts. Hooks, tools, commands, reminders and the completion gate apply request-local selectors without changing the process environment.
- Missing or invalid selected plans fail closed, and conflicting explicit directory arguments return an error. Existing ambiguity refusal, attachment admission, link checks and attestation remain…
- @Vyzygota (Piotr Maziarz), for reproducing the gateway selection gap and specifying session binding, cross-root selection and concurrency requirements in #328.
Planning With Files by Ahmad Othman Ammar Adi
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.
Agent tooling for cost, context and memory
New · Added to AgentGid on Oct 13, 2026Open source · MITFree to start
Recently added on Oct 13, 2026. The description, category and pricing were filled in from public metadata and have not been checked by an editor yet.
Price
Free (OSS)
free and open source
Popularity
#51 in Agent tooling
Gid Score 27 / 100 · #51 of 65 ranked agent tools
Trend
Gaining stars
about +21 GitHub stars a day
Development
Actively updated
latest 3.25.0, yesterday
Community
27.6K GitHub stars
public signals
Usage data: latest readings Oct 20 to Oct 21, 2026, last checked Oct 21, 06:38 UTC. Date of each number
What Planning With Files does
It is free and open source (MIT); you pay only for the models it calls.
Key facts
| Maker | Ahmad Othman Ammar Adi |
|---|---|
| First released | January 2026 |
| License | MIT |
| Main language | Python |
| Open issues and PRs | 8 |
Pricing
Open source under the MIT licence; check the website for any paid hosted plans.
, checked Oct 13, 2026. Prices change often; confirm before you buy.
Quick answers
- Free to start?Yes
- Open source?Yes (MIT)
- Closest alternativeOpenShell · all alternatives
Planning With Files alternatives
Best Planning With Files alternatives compared · All agent tooling for cost, context and memory
| # | Agent | Gid Score | Downloads 7d | 7d | 30d | Stars | Latest release | Price | |||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 |
OpenShellNVIDIA |
77 | 101K | down 14.1% | up 381.4% | 16.8K+103/day | 0.1.5yesterday | Free (OSS) | |||
| 2 |
|
72 | 22.9M | up 4.3% | — | 61.7K+79/day | 1.104.5today | Free (OSS) | |||
| 3 |
NVIDIA NemoClawNVIDIA |
69 | — | — | — | 22.8K+10/day | — | Free (OSS) | |||
| 4 |
|
64 | 9.5M | down 17.1% | up 17.7% | 36.1K+48/day | 4.66.0yesterday | Free + $29/mo | |||
| 5 |
|
64 | 2M | down 19.8% | up 0.3% | 194K+350/day | 2.11.04mo ago | Free + $16/mo | |||
| 6 |
|
60 | 3.2M | down 14.5% | up 21.9% | 14.5K+21/day | 2.11.2yesterday | Free + $150/mo | |||
| No agents match that filter. | |||||||||||
Ratings from people who use Planning With Files
No ratings yet. Used Planning With Files? Rate it and say what it is good and bad at.
Planning With Files news
-
Planning With Files 3.25.0 released
planningwithfilesselect selects or clears a conversation's plan, including a plan in another project. Successful named initialization also selects its new plan.; Reading a named taskplan.md selects it only for an unbound conversation. Successful writes and…
-
Planning With Files 3.24.3 released
@littleblacklb, for the progress-attestation workflow report and safety requirements that prompted the review (#326). The contribution is recorded in CONTRIBUTORS.md. (+1 more release that day)
-
10 agents added to AgentGid
Browser Harness, Vane, TencentDB-Agent-Memory, Distilly, Codex With Chatgpt, Siyuan, Planning With Files, AionUi, PageIndex, Anatomy
What changed: recent Planning With Files releases
40 stable releases in the last 90 days · Full changelog
- @littleblacklb, for the progress-attestation workflow report and safety requirements that prompted the review (#326). The contribution is recorded in CONTRIBUTORS.md.
Earlier releases
- @littleblacklb for reporting repeated Pi plan injection and implementing the session-scoped suppression, recovery handling and regression tests (#323, #324).
- @Enard52 for the KiloCode link repair and hidden-adapter discovery fixtures (#317, #318).
- @Amiirhosseini for the contributor setup guide, the tracked-inventory proposal, and the overlapping KiloCode link repair (#320, #321, #322).
- The Qoder plugin installs the planning skill and seven lifecycle hooks. Its launcher uses isolated Python startup through Bash, and the adapter maps the optional completion gate to Qoder CLI's…
- Claude Code plugin and standalone skill hooks suppress unchanged PreToolUse views after successful prompt injection. A changed visible view refreshes once. Sessions, agents, selected plans and…
- File-only SessionStart recovery starts its catch-up child with isolated Python startup, preventing PYTHONPATH startup code from loading in that child.
- calm (@shouldnotappearcalm), for Qoder support and lifecycle tests (#313).
- @mfehlhaber, for the repeated-injection report and recovery cases (#312), and for the earlier npm package report (#213).
- examples/file-only-recovery/ provides a halfway checkpoint, completed reference task, receipt template and objective grader. File-only, baseline and replay arms remain separate, and explicitly…
- dsh-planning-with-files 1.0.1 uses the producer-owned plugin:planning-with-files source for every injection route, retains legacy message deduplication and has a consistent development dependency…
- Manual /plan-goal and topic-handoff guides use the installed resolver, stop on invalid pins or ambiguous selection, and document its legacy-root convention.
- The Codex guide describes the registered Python adapter's silent opt-out correctly.
- @as992949791 for the manual resolver guidance (#304).
- @ShaunLinTW for the Codex opt-out correction (#308).
Planning With Files popularity and usage data
The GitHub repository has 27.6K stars, 632 of them added in the last 30 days. The latest stable release is 3.25.0, published Oct 20, 2026; there were 12 stable releases in the past 30 days. It was mentioned in 1 Hacker News posts and comments over the last 30 days.
Download the raw daily series: planning-with-files.csv
Gid Score breakdown
Adoption16
Community60
Attention0
Momentum51
Each component is scored 0 to 100 from public signals; a dash means no data for it. Methodology.
How fresh these numbers are
| Number | Latest reading | Last checked |
|---|---|---|
| GitHub stars | Oct 21, 2026 | Oct 21, 06:33 UTC |
| Website rank (Tranco) | Oct 20, 2026 | Oct 21, 06:38 UTC |
| Hacker News mentions | Oct 20, 2026 | Oct 21, 06:33 UTC |
We fetch every source once a day. Registries publish downloads and page views a day or two late, so their latest reading trails the check. A reading more than 4 days old is marked out of date; the Gid Score still uses it until a newer one arrives.
Planning With Files FAQ
How much does Planning With Files cost?
Open source under the MIT licence; check the website for any paid hosted plans.
Is Planning With Files open source?
Yes. Planning With Files is open source, released under the MIT license.
How popular is Planning With Files?
The GitHub repository has 27.6K stars, 632 of them added in the last 30 days. The latest stable release is 3.25.0, published Oct 20, 2026; there were 12 stable releases in the past 30 days. It was mentioned in 1 Hacker News posts and comments over the last 30 days.
What is the latest version of Planning With Files?
The latest stable release we track is 3.25.0, published on Oct 20, 2026.
What are the alternatives to Planning With Files?
The closest alternatives in the same category by Gid Score are OpenShell, LiteLLM, NVIDIA NemoClaw, Langfuse.
For the makers of Planning With Files badges, corrections
Add a live badge to your README or site:
[](https://agentgid.com/agents/planning-with-files/)[](https://agentgid.com/agents/planning-with-files/)Something wrong or outdated on this page? Send a correction with a link to the official source. More for makers.
Where these numbers come from
GitHub: othmanadi/planning-with-files. Site rank: here.now on the Tranco list. See data sources for how each one is collected.
Product facts and pricing were checked against: gilded-laurel-c7nj.here.now, github.com.