Turn any folder into AI-ready text. Requires Folder2Text app from Microsoft Store.
Project description
Folder2Text CLI
Turn any folder into AI-ready text. Bundle code context for ChatGPT, Claude, Gemini, NotebookLM, LLaMA, Mistral, DeepSeek, Grok and other LLMs.
Requirements
- Folder2Text app installed from Microsoft Store
- Python 3.10+
- Windows 10/11
Install
pip install folder2text
Quick Start
# Extract a folder and pipe to clipboard (paste into ChatGPT/Claude)
folder2text ./myproject --stdout | clip
# Extract to a file
folder2text ./myproject -o context.txt
# Check license and trial status
folder2text status
How It Works
The CLI connects to the Folder2Text desktop app's local REST API. The app handles extraction, filtering, and licensing. The CLI is a thin terminal client -- it requires the app to be installed and running.
folder2text CLI ---> localhost API ---> Folder2Text.exe (Store)
(port + secret) extraction + trial logic
All processing happens locally. Your code never leaves your machine.
Why Folder2Text?
- LLM-Ready Output: Structured text formatted for maximum context window efficiency
- Smart Filtering: Auto-excludes node_modules, .git, binaries, and lock files
- 100% Private: Everything runs locally, no cloud, no telemetry
- 31 Languages: UI available in 31 languages
- Lightweight: ~90MB app, zero-dependency CLI
Commands
| Command | Description |
|---|---|
folder2text <paths...> |
Extract folder(s) to output file |
folder2text <paths...> --stdout |
Print extracted text to stdout (pipe to LLM) |
folder2text <paths...> -o FILE |
Custom output file name |
folder2text status |
Show license tier and trial remaining |
folder2text --version |
Show CLI version |
folder2text --help |
Show help + Store link |
Pricing
- Free trial: 3 extractions (up to 500 files each)
- Standard: 14.99 EUR one-time (lifetime license)
- Pro Monthly: 6.99 EUR/month
- Pro Annual: 59 EUR/year (save ~30%)
All payments handled through Microsoft Store.
Links
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file folder2text-1.0.0.tar.gz.
File metadata
- Download URL: folder2text-1.0.0.tar.gz
- Upload date:
- Size: 6.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1fff88e12006ba887dff5d3cb05a4f67d48e2a6e43f7c44f4083c77e9d885fce
|
|
| MD5 |
5e0d8aa64f6cc54534855010cf1b3d9f
|
|
| BLAKE2b-256 |
a087f66c44fd16f5e69a9566e70eb43813d0233e6680ead89161c7fc4f567837
|
File details
Details for the file folder2text-1.0.0-py3-none-any.whl.
File metadata
- Download URL: folder2text-1.0.0-py3-none-any.whl
- Upload date:
- Size: 7.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b22d75f7eb900b6ca8ac1606d395dd5559bb1db20b4fc5fe725f8dc355972ece
|
|
| MD5 |
bad9f87ac77a3b87bcca5d205c58c395
|
|
| BLAKE2b-256 |
e2f828081d289953b480d68bf17a73faebc7ede706af8939ef9d4cf689e107a2
|