All docs

Installation

Squeezr is a transparent compression proxy for AI coding tools. It sits between your tool and the LLM API, reducing token usage by 60–95% with zero changes to your workflow.

Requirements

  • Node.js 18+ — Squeezr is built on Node and requires version 18 or later (compatible with Node.js 24). Check with node --version.
  • macOS, Linux, WSL, or Windows — all platforms are fully supported. Native Windows works out of the box.
  • An API key for at least one supported provider (Anthropic, Google, or a local model via Ollama). Codex users authenticate via their ChatGPT subscription — no extra API key needed.

Install via npm

Install Squeezr globally so the CLI is available everywhere:

npm install -g squeezr-ai

Or with your preferred package manager:

# pnpm
pnpm add -g squeezr-ai

# yarn
yarn global add squeezr-ai

Verify the installation

squeezr version

Run setup

Run the one-time setup command. It configures everything automatically — no manual env var editing required:

squeezr setup

This command will:

  1. Set ANTHROPIC_BASE_URL and GEMINI_API_BASE_URL to point at the proxy (saved to your user environment, not just the current session).
  2. Install a shell wrapper in your PowerShell $PROFILE (Windows) or ~/.bashrc / ~/.zshrc (Linux/macOS/WSL) that auto-refreshes env vars after squeezr start, squeezr setup, or squeezr update — no terminal restart needed.
  3. Register auto-start so the proxy restarts after a reboot (Task Scheduler on Windows, systemd on Linux, launchd on macOS).
  4. Windows: import the MITM CA into the Windows Certificate Store (user-level, no admin required) so Rust-based CLIs like Codex trust the proxy's TLS certificates.
  5. macOS/Linux/WSL: generate a CA bundle at ~/.squeezr/mitm-ca/bundle.crt and set NODE_EXTRA_CA_CERTS.

Updating

Use the built-in update command — it kills the running proxy, installs the latest version from npm, and restarts automatically:

squeezr update

Uninstalling

Remove Squeezr completely including env vars, CA certificates, auto-start registration, and log files:

squeezr uninstall

Then uninstall the package:

npm uninstall -g squeezr-ai

Next steps

Head to the Quick Start for an end-to-end walkthrough, or jump straight to the guide for your specific tool: Claude Code, Codex, Aider, Gemini CLI.