Context Packing Previewer
Preview file selection, exclusions, token estimates, and truncation risk before an AI coding session.
The problem it solves
Context Packing Previewer [](https://github.com/loganpendragonmultiverse/context-packing-previewer/actions/workflows/ci.yml)
Who Context Packing Previewer is for
- Developers and maintainers who need reviewable evidence before changing or releasing software.
- Users working with AI coding, context windows, token estimates who want the documented v1.0.0 behavior.
- People who prefer an open-source release with visible limitations, source, and license terms.
Intended result
Preview file selection, exclusions, token estimates, and truncation risk before an AI coding session.
This summary is reconciled from the current catalog and repository documentation.
Features in v1.0.0
Capabilities below come from the current project README and release documentation.
[](https://github.com/loganpendragonmultiverse/context-packing-previewer/actions/workflows/ci.yml)
Context Packing Previewer shows which local files would enter an AI coding context, estimates their token footprint, records exclusions, and warns when a chosen budget is close or exceeded. Nothing is uploaded.
Verified examples
Screenshots are shown only when the current README references a local source image. Otherwise, repository example files are linked directly.
Platforms and implementation
The public release claims only the cataloged platforms and technologies.
Supported platforms
- Windows
- macOS
- Linux
Built with
- Python
Quick start
The shortest documented path into the current release.
python -m pip install .
context-preview . --include "src/**/*.py" --include "tests/**/*.py" --budget 32000
context-preview . --exclude "fixtures/**" --format jsonThe estimate deliberately uses a transparent four-characters-per-token approximation rather than claiming tokenizer-exact billing. Reports identify binary, non-UTF-8, oversized, and excluded files. Default exclusions cover common build directories, repositories, virtual environments, environment files, and private-key extensions.
Current limitations
These boundaries are part of the product and prevent the page from implying unverified capability.
This is a read-only preview, not a secret scanner or an AI client. Review the final file list yourself. Symlinks are skipped, and no file contents appear in the report, but filenames and absolute root paths can still be sensitive.
Requires Python 3.10 or newer. Development checks use Ruff, pytest with branch coverage, and package builds.
Part of the Logan Pendragon Forge open-source collection. Licensed under the [MIT License](LICENSE).
Privacy and licensing
Review the actual data boundary before using a tool with sensitive inputs.
Privacy and safety
No privacy behavior beyond the current repository documentation is claimed. Review the source, security policy, and input/output behavior before using sensitive material.
License and release
Context Packing Previewer is published under MIT. The current cataloged release is v1.0.0, published 2026-07-27.
Related projects
Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.
Context Packing Previewer v1.0.0
Use the tagged release for downloads and release notes. Use the repository for source, issues, contribution guidance, security reporting, and complete documentation.
Page source: current Forge catalog plus README and CHANGELOG from the canonical local repository. Fingerprint: d156d405352efd18.