Planning With Files AI Agent
by OthmanAdiPersistent 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.
Planning With Files is an open-source ai agent by OthmanAdi, written mainly in Shell, with 27,804 GitHub stars and the MIT license. Its code was last updated Oct 30, 2026. The latest npm release is planning-with-files 3.27.0, published Oct 30, 2026, with 211 downloads last week.
Scan summary: scanned Nov 5, 2026 at commit 8eef6dc. No capabilities flagged by our checks. Scan policy
What Planning With Files can touch
- Our checks did not find this. The tool may still do it.Run shell commandsNot seen in this scan
- Our checks did not find this. The tool may still do it.Run dynamic codeNot seen in this scan
- Our checks did not find this. The tool may still do it.Read or write filesNot seen in this scan
- Our checks did not find this. The tool may still do it.Read environment and secretsNot seen in this scan
- Our checks did not find this. The tool may still do it.Control a web browserNot seen in this scan
- Our checks did not find this. The tool may still do it.Connect to databasesNot seen in this scan
- Our checks did not find this. The tool may still do it.Read or send messagesNot seen in this scan
- Our checks did not find this. The tool may still do it.Touch money or tradingNot seen in this scan
- Our checks did not find this. The tool may still do it.Connect to the internetNot run in this scan
"Not seen" means our checks did not find it, and the tool may still do it. Covers commit 8eef6dc, Nov 5, 2026. See the scan policy.
Before you install Planning With Files
AgenticMart scanned Planning With Files on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.
What it can access
- An AI agent decides its own next steps and calls whatever tools you give it, so its risk depends on the access you grant.
- Based on its description and topics, it likely needs to read and write files on your machine.
- Based on its description and topics, it likely needs to use a code-hosting token (GitHub/GitLab).
Before you install
- Point it at one project folder, never your home directory.
- Use a fine-grained token limited to the repos it needs.
- Pin the version you reviewed instead of always installing the latest release.
- Read the tool list or scripts before the first run, and keep approval prompts on for actions that write, send or delete.
- Maintained by OthmanAdi on GitHub, 27,804 stars and 2,308 forks. Popularity is not proof of safety.
- Last code change: Oct 30, 2026.
- Open-source license: MIT.
Planning With Files is an open-source ai agent by OthmanAdi, written mainly in Shell. 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.
At a glance
- Stars
- 28k
- Forks
- 2.3k
- Language
- Shell
- License
- MIT
- Created
- Jan 2026
- Last update
- Oct 30, 2026
- Type
- AI Agent
- Price
- Free
Topics
Questions about Planning With Files
What is 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.
Who maintains Planning With Files?
Planning With Files is maintained by OthmanAdi on GitHub (OthmanAdi/planning-with-files). AgenticMart lists it from public repository data.
Is Planning With Files safe to use?
AgenticMart scanned Planning With Files on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.
What license does Planning With Files use?
It is published under the MIT license.
Planning With Files alternatives
View more →Similar ai agents in Coding Agents, ranked by GitHub stars. Compare licence, recent activity and scan status before you choose.
| Name | Stars | Licence | Last updated | Scan |
|---|---|---|---|---|
| Planning With Files (this page) OthmanAdi | 28k | MIT | Oct 30, 2026 | Scanned, no flagged issues |
| AutoGPT Significant-Gravitas | 188k | None found | Nov 1, 2026 | Not scanned yet |
| Langchain langchain-ai | 149k | MIT | Nov 1, 2026 | Scanned, no flagged issues |
| Gemini CLI google-gemini | 109k | Apache-2.0 | Nov 1, 2026 | Scanned, no flagged issues |
| MetaGPT FoundationAgents | 71k | MIT | Jan 21, 2026 | Scanned, no flagged issues |
| Oh My Openagent code-yeongyu | 71k | None found | Nov 1, 2026 | Not scanned yet |