ctxpack v1.0.0

Important

About this tag and the PyPI package. This tag is historical: it points to the code as it was named ctxpack, before the PyPI distribution was renamed to ctxpack-cli (the name ctxpack on PyPI belongs to an unrelated project). The package published at pypi.org/project/ctxpack-cli (version 1.0.0) was therefore built from a later commit on main, not from this tag's tree — it additionally includes bug fixes #20–#25 (CJK token-budget truncation, summary counts, strict-mode CLI excludes, custom base_name self-repacking, markdown fence nesting, UTF-16/BOM file support). Install with pip install ctxpack-cli. Future releases will be tagged from main after merge so tags and PyPI always match.

ctxpack v1.0.0

Zero-dependency CLI for packaging context windows from codebases.

What's New

Core Features

• Context window packaging — Bundle code files into token-limited context windows
• Multiple format support — JSON, YAML, TOML, Java .properties
• Path-based filtering — Include/exclude files using glob patterns
• Token counting — Accurate token estimation for LLM context limits
• Security-first — Automatic redaction of secrets (passwords, tokens, API keys)
• Flexible output — Terminal, JSON, Markdown reports

Security

• Default redaction of sensitive patterns
• Budget validation — reject negative budgets with clear error messages
• No external dependencies — zero supply chain risk

Quality

• 121 passing tests
• Full CI/CD pipeline with GitHub Actions
• Linting enforced via ruff and pre-commit

Installation

git clone https://github.com/billybox1926-jpg/ctxpack.git
cd ctxpack
pip install -e .
# or
pip install ctxpack-1.0.0-py3-none-any.whl

Or straight from PyPI:

pip install ctxpack-cli

Quick Start

# Pack a context window
ctxpack pack --input ./src --output context.json --budget 4000

# View configuration
ctxpack config show

# Initialize config
ctxpack config init

License

MIT