produm 0.2.0

Flatten a project into a single LLM-friendly text dump

produm

produm is a tiny CLI tool that flattens any small project into a single, LLM-friendly document. Useful when you want to show an entire codebase to ChatGPT or other LLMs without manually copying files. This was created for Python projects, but it could be generalized for other projects.

Features

• Generates a single .md dump with:
  • Directory tree
  • File list
  • All text-based file contents
• Respects .gitignore (can be disabled)
• Skips binary files automatically
• Supports include/exclude rules
• Optional line numbers for code review and debugging
• Output name auto-generated unless specified
• Optional PDF export via Pandoc
• Clean command removes prior dump artifacts

Installation

uv add produm

or

pip install produm

Usage

Basic

produm

or

produm .

will clean old dumps, then create a new dump file from and in the current directory.

Subcommands

Dump only:

produm dump .

Clean only:

produm clean .

Dry-run cleaning:

produm clean . --dry-run

Advanced

Specify output:

produm dump . -o dump.md

Only include Python files:

produm dump . --include-ext .py

Skip the directory tree:

produm dump . --no-tree

Export PDF only:

produm dump . --pdf

PDF export requires pandoc and xelatex.

License

See LICENSE