Context Compressor v1.0.0

Context Compressor v1.0.0 🦅

Pure context compression engine — not a memory manager, a lifesaver.

Compresses current conversation context from 180k → 35k instantly.

Core Features

Feature	Description
Auto-trigger	Compresses at 70% context threshold
4 Levels	light/normal/heavy/emergency
Structured JSON	Full stats: tokens, ratio, counts
System preserved	Role definitions never compressed
Importance filter	Discards noise, keeps decisions/rules
Pure Python	No database, no dependencies

Quick Start

chmod +x scripts/hawk-compress
hawk-compress --level normal

Python API

from hawk_compress import ContextCompressor
c = ContextCompressor(keep_recent=5)
result = c.compress(chat_history)
print(result["stats"]["ratio"])