pconcat (Project Concatenator)

A command-line tool to concatenate project contents into a single output, made for sharing context with AI assistants.

Features

• Directory tree structure generation
• Text file content concatenation
• Flexible output: clipboard, file, or shell
• .pconcatignore file support
• Command to generate standard .pconcatignore
• Single file reading support

Installation

1. Install Python 3.6+
2. Clone repository
3. Make executable:

   chmod +x /path/to/pconcat

4. Add to PATH:

   sudo mv /path/to/pconcat /usr/local/bin/

5. Install dependencies:

   pip install pyperclip

Usage

pconcat [options] [-t TARGET]

Options

• -t, --target: Target directory/file (default: current directory)
• -f, --file: Output to file
• -s, --shell: Print to shell
• -i, --init: Create .pconcatignore
• --no_filename: Exclude filenames
• --no_tree: Exclude directory tree
• --no_contents: Exclude file contents

Examples

# Copy to clipboard
pconcat

# Output to file
pconcat -f output.txt

# Print to shell
pconcat -s

# Create .pconcatignore
pconcat -i

Dependencies

• Python 3.6+
• pyperclip

License

MIT License

Links

• GitHub Repository
• Issues

Author

Scezaquer - @Scezaquer