Skip to content

mc-marcocheng/pctx

Repository files navigation

pctx

pctx demo

Crates.io version License: MIT Documentation

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 for integration with other tools
  • 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.

About

Generate LLM-ready context from your codebase.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages