PromptPack

A pure Bash-based interactive file bundler for LLM prompting, inspired by lazygit’s UI and functionality.

Features

• Interactive, pane-split file and directory selection via fzf with syntax-highlighted previews (bat).
• Includes hidden files, expands directories into all contained files, and filters out .zip files by default.
• Generates a Markdown-formatted payload with a tree of selected roots and fenced code blocks for each file’s contents.
• Copies the payload to the system clipboard (pbcopy, xclip, or wl-copy).
• Provides an on-screen preview in a tmux split (or pager fallback).
• Automatically checks for required dependencies before running.

Dependencies

• bash (≥ 4.0)
• fzf
• tree
• bat (or batcat)
• pbcopy (macOS) or xclip/wl-copy (Linux)
• tmux (optional, for split-pane preview)

Installation

1. Save promptpack.sh to your preferred location:

   chmod +x promptpack.sh
   mv promptpack.sh /usr/local/bin/promptpack

2. Ensure dependencies are installed (e.g., on macOS via Homebrew):

   brew install fzf tree bat tmux

Usage

promptpack [options]

• Run without arguments for an interactive session.
• Select files or directories (space to toggle, enter to confirm).

Acknowledgements

• @3rd's promptpack and its functionality.
• lazygit and its UI.
• npm and its frustrating dependency management.
• fzf and its fuzzy finder.
• bat and its syntax highlighting.
• tmux and its split panes.
• tree and its directory tree visualization.
• pbcopy/xclip/wl-copy and their clipboard management.
• bash and its scripting capabilities.

License

This project is licensed under the MIT License.