Skip to main content

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.

Available on Microsoft Store License: MIT Python 3.10+

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

folder2text-1.0.0.tar.gz (6.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

folder2text-1.0.0-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

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

Hashes for folder2text-1.0.0.tar.gz
Algorithm Hash digest
SHA256 1fff88e12006ba887dff5d3cb05a4f67d48e2a6e43f7c44f4083c77e9d885fce
MD5 5e0d8aa64f6cc54534855010cf1b3d9f
BLAKE2b-256 a087f66c44fd16f5e69a9566e70eb43813d0233e6680ead89161c7fc4f567837

See more details on using hashes here.

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

Hashes for folder2text-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b22d75f7eb900b6ca8ac1606d395dd5559bb1db20b4fc5fe725f8dc355972ece
MD5 bad9f87ac77a3b87bcca5d205c58c395
BLAKE2b-256 e2f828081d289953b480d68bf17a73faebc7ede706af8939ef9d4cf689e107a2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page