What is squeeze?
Squeeze is a command-line tool that compacts output from developer tools before it reaches a coding agent. It parses supported formats to retain changes, failures, and decisions, while noting what it removed and how to show more detail. Developers can pipe command output through it from any agent that runs shell commands, without adding an MCP server, plugin, or hook. It also supports unrecognized text through a generic format.
squeeze Features:
Format Detection: Squeeze detects the input format, with specific parsers for Terraform, tests, build logs, Kubernetes, audits, and other tools.
Change Summaries: For supported formats, it keeps the changes, failures, and decisions that an agent may need to act on.
Cut Reporting: It reports how much content was removed and names the flag that can reveal more detail.
Sensitive Values: Values marked sensitive by the input tool are excluded from standard output and JSON output.
Shell Pipeline: It reads from standard input and writes compacted output, so it can be placed after a command in a shell pipeline.
Failure Exit Codes: The optional --fail-on error,fail flag makes Squeeze exit with code 3 when it detects a failure.
Generic Text: When input does not match a supported tool format, Squeeze can process it as generic text.
squeeze Benefits:
Smaller Agent Context: Reducing lengthy command output can leave more of an agent’s context available for the code and task at hand.
Faster Output Review: A focused summary can make it easier for developers to spot consequential results without scanning every line of a large output.
Visible Omissions: The removal note helps users judge whether the summary is enough or whether they need to inspect additional details.
Lower Secret Exposure: Keeping tool-marked sensitive values out of the output reduces the chance that those values appear in an agent’s captured context.
Fewer Agent Additions: Using a shell pipe avoids the need to set up a separate server, plugin, or hook for an agent to access compacted output.
Use Cases:
Terraform Plan Review: Pipe Terraform plan JSON through Squeeze to review proposed additions, changes, removals, and replacements in a compact summary.
Test Failure Triage: Use it with Go tests, Jest, Vitest, JUnit XML, or pytest output to focus an agent on test results and failures.
Build Log Investigation: Compact Docker Buildx output or GitHub Actions run logs when an agent needs to investigate a build or workflow failure.
Security Audit Review: Process npm audit, Checkov, or Trivy output to help inspect findings without passing the full report into an agent.
Kubernetes Inspection: Pipe kubectl JSON output through Squeeze when an agent needs to examine resources returned by a cluster query.