ImmaZoni/PromptPacker

Consolidate your code project into a single, navigable Markdown file. Perfect for Large Language Models (LLMs).

โ˜… 2Forks 0GoGitHub โ†—Compare

README

๐Ÿš€ PromptPacker

Consolidate your code project into a single, LLM-ready Markdown file.

License: MIT Go Version

PromptPacker scans your project and generates a single Markdown file containing your directory structure and file contents โ€” ready to paste into ChatGPT, Claude, Gemini, or any other LLM.

Features

  • Interactive TUI โ€” Beautiful terminal UI for selecting files when no args are given
  • File-Spec Mode โ€” Explicitly choose which files/directories to include
  • Auto Mode โ€” Scan the entire directory tree automatically (--mode auto)
  • Structure-Only โ€” Output just the directory tree, no file contents (--structure-only)
  • Preview Before Output โ€” See what will be included before writing the file
  • Extension Filtering โ€” Include or exclude by file extension (--include-ext, --exclude-ext)
  • Git-Aware โ€” Only include changed files (--changed, --since, --branch)
  • Config File โ€” Save defaults per-project in .promptpacker.yml, with named profiles
  • Max File Size โ€” Automatically skip files above a size threshold (--max-file-size)
  • .gitignore Support โ€” Respects your gitignore rules out of the box
  • Fast โ€” Concurrent processing with worker pool, streams to disk

Documentation

Guide Description
Getting Started Installation + first run
CLI Reference All flags and options
Config File Guide .promptpacker.yml format and profiles
Examples & Recipes Common real-world use cases
Exclusion Logic How file filtering works

Quick Start

# Interactive file selector (default โ€” pick what to include)
promptpacker

# Include specific files/dirs
promptpacker src/ cmd/ go.mod README.md

# Scan entire directory automatically
promptpacker --mode auto

# Only output the directory tree
promptpacker --mode auto --structure-only

# Skip preview and generate immediately
promptpacker src/ --force

Installation

Windows

irm https://raw.githubusercontent.com/immazoni/promptpacker/main/scripts/install-windows.ps1 | iex

macOS / Linux

curl -sSL https://raw.githubusercontent.com/immazoni/promptpacker/main/scripts/install.sh | bash

Build from source

git clone https://github.com/immazoni/promptpacker.git
cd promptpacker
go build -o promptpacker promptpacker.go

See Getting Started for full installation instructions.

License

MIT License

Contributors

ImmaZonigoogle-labs-jules[bot]

Issues