The Architecture of a Transparent CLI Proxy

ContextZip wraps your shell commands without changing their behavior. No modified binaries. No PATH manipulation. No LD_PRELOAD tricks. Here's how. The Shell Function Approach contextzip init outputs a shell function. For zsh: contextzip_exec() { local output output=$("$@" 2>&1) local exit_code=$? echo "$output" | contextzip filter return $exit_code } This simplified version shows the core idea. The real implementation handles: Separate stdout/stderr capture Signal forwarding (Ctrl+C propagation) TTY detection (interactive vs. pipe mode) Streaming for long-running commands The Filter Pipeline When output enters contextzip filter, it passes through a pipeline of processors: Raw Output → ANSI Stripper (remove escape codes) → Pattern Detector (identify output type) → Stack Trace Filter (language-specific) → Duplicate Grouper (semantic matching) → Noise Remover (progress bars, spinners) → Stats Reporter (savings calculation) Clean Output Each stage is independent. If the pattern det