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 patter