OthmanAdi/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.
Build with Backblaze B2
SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.
Loading star history...
Where it stands
Rank, growth pace and release cadence relative to everything GStars tracks.
5 releases in the last 90 days, the latest 4 days ago, with 61 contributors on GitHub.
Use Cases & Benefits
- Implements persistent file-based planning and session recovery for AI coding agents using markdown files to track tasks, findings, and progress.
- Ensures crash-proof, deterministic task management with automatic session recovery and context reinjection to prevent goal drift and context rot.
- Use for managing complex multi-step AI coding tasks that require durable memory beyond volatile context windows.
- Use for orchestrating long-running autonomous agent workflows with error logging and progress verification.
- Use for integrating Manus-style planning patterns into Claude Code, Cursor, Codex, and other agent platforms supporting Agent Skills.
Should you depend on it?
License terms, project hygiene and risks, from GitHub metadata and GStars' snapshots.
License
MIT
Permissive: commercial use, modification and redistribution are allowed with attribution.
Community files
- README: present
- Contributing guide: present
Watch-outs
No watch-outs from GStars' checks.
General guidance from repository metadata, not legal advice. How we score
From the README
Work like Manus — the AI agent company Meta acquired for $2 billion.
A Claude Code plugin that transforms your workflow to use persistent markdown files for planning, progress tracking, and knowledge storage — the exact pattern that made Manus worth billions.
Works with Claude Code, Cursor, Codex, Gemini CLI, and 40+ agents supporting the Agent Skills spec.
That's it! Now use one of these commands in Claude Code:
Alternative: If you want
/planning-with-files(without prefix), copy skills to your local folder:See docs/installation.md for all installation methods.
On December 29, 2025, Meta acquired Manus for $2 billion. In just 8 months, Manus went from launch to $100M+ revenue. Their secret? Context engineering.
"Markdown is my 'working memory' on disk. Since I process information iteratively and my active context has limits, Markdown files serve as scratch pads for notes, checkpoints for progress, building blocks for final deliverables." — Manus AI
Daily snapshots
Stars gained per day, and how forks and open issues moved, from GStars' daily snapshots
Forks
2.3K+129
Open issues
11+5
Compared with peers in Automation
Fastest-growing repositories GStars tracks in this cohort for the week of Nov 8, by 7-day star growth
| Repository | Stars | +7d | Health | Last release |
|---|---|---|---|---|
| vercel-labs/agent-desktop | 21.4K | +8.7K | 75 | 5 days ago |
| D4Vinci/Scrapling | 101.1K | +6.3K | 75 | 6 days ago |
| harry0703/MoneyPrinterTurbo | 142.0K | +3.8K | 75 | 3 days ago |
| superplanehq/superplane | 9.8K | +1.0K | 75 | 13 days ago |
| gosom/google-maps-scraper | 7.9K | +622 | 75 | 2 days ago |
| OthmanAdi/planning-with-files | 27.9K | — | 60 | 4 days ago |
| Category median | 21.4K | +3.8K | 75 | — |
Discover Repositories
Search across tracked repositories by name or description