Large File Interceptor

What it does

A single large file paste can consume 60–80% of the context window, leaving no room for actual work. Large File Interceptor detects oversized files, generates a structural summary (schema, columns, imports, key definitions), stores the original externally, and replaces it with a compact reference card.

Inspired by lossless-claw's large file interception layer, which automatically extracts files exceeding 25k tokens.

When to invoke

• Before processing any file the agent reads or receives — check size first
• When context budget is running low and large files may be the cause
• After a paste or file read — retroactively scan for oversized content
• Periodically to audit what's consuming the most context budget

How to use

python3 intercept.py --scan <path>                # Scan a file or directory