pctx

Generate LLM-ready context from your codebase. Intelligently packages source files with proper formatting, truncation, and filtering for optimal AI assistant consumption.

Features

• Smart file discovery: Respects .gitignore, excludes binary files, and filters common non-source directories
• Multiple output formats: Markdown (default), XML, and plain text
• Intelligent truncation: Preserves file head and tail when truncating large files
• Flexible filtering: Include/exclude patterns with gitignore-style syntax
• Multiple destinations: stdout, clipboard, or file output
• JSON mode: Structured output for programmatic use and CI/CD integration
• Stdin support: Read file lists from pipes, including NUL-delimited input (--stdin0, --paths-file0), for integration with other tools
• Path aliases: Combine files from unrelated roots under short display names with --path-alias
• Token estimation: Approximate token counts for various LLM models

Installation

cargo install pctx

Quick Start

# Generate context for current directory
pctx

# Copy to clipboard
pctx --clipboard

# Write to file
pctx --output context.md

See the Documentation for advanced usage, filtering, and configuration options.