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.
By leveraging Python SDK / OpenAI API, the application isolates runtime dependencies while maintaining low-latency execution traces across multi-step LLM operations.
High-throughput parsing of complex documents (PDFs, Word docs, spreadsheets, presentations)
Structured table, key-value, and metadata extraction directly into agent memory buffers
Automated report generation and document synthesis from multi-source repositories
{
"mcpServers": {
"planning-with-files": {
"command": "python",
"args": [
"-m",
"planning_with_files"
]
}
}
}
Paste into your client configuration file (e.g. ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%/Claude/claude_desktop_config.json on Windows).
Clone OthmanAdi/planning-with-files from GitHub
Install dependencies with pip install -r requirements.txt (or uv sync)
Copy .env.example to .env and add your API keys
Run the skill server and connect your AI client via stdio or HTTP
Keeps heavy parsing and raw file structures external to the LLM. Only sanitized excerpts and structured returns are injected into agent memory turns.
Enforce explicit directory allowlists and permission scopes in client configuration to ensure autonomous tool calls never breach system boundaries.
Executes in an isolated local child process communicating strictly over JSON-RPC via stdio with explicit process timeouts.
Planning With Files is an open-source document capability designed for AI clients and autonomous agents. 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.
Follow the step-by-step installation: 1) Verify your runtime (Python 3.10+), 2) Add the configuration snippet into your AI client settings (e.g. claude_desktop_config.json), 3) Restart the client to initialize tool execution.
Planning With Files is compatible with all AI tools supporting tool-calling and the Model Context Protocol (MCP), including Claude Desktop, Cursor, Claude Code CLI, Windsurf, OpenCode, and custom agent runtimes.
Planning With Files executes locally with strict directory allowlists and permission scopes. Heavy parsing and raw file structures stay external to the LLM context window to prevent memory saturation and unauthorized access.
Yes, Planning With Files is published under the MIT open-source license. You can inspect the source code and contribute on GitHub at https://github.com/OthmanAdi/planning-with-files.
Explore open-source implementation code, license, and community releases.
Anthropic's official Claude Skills for working with document formats — fill, merge, and extract data from PDFs, Word files, PowerPoint decks, and Excel spreadsheets inside agent workflows.
Reverse engineer anything with agents, from app behavior down to native binaries.
A powerful business consultant powered by Google's Agent Development Kit that provides comprehensive market analysis, strategic planning, and actionable business recommendations with real-time web research.
Advanced AI AgentsAn intelligent meal planning agent built with Agno that helps you discover recipes, analyze nutrition, estimate costs, and create weekly meal plans based on your ingredients and dietary preferences.
Advanced AI AgentsAn AI application that simulates a full-service digital agency using multiple AI agents to analyze and plan software projects. Each agent represents a different role in the project lifecycle, from strategic planning to technical...