CLI Commands

The Squeezr CLI manages the proxy lifecycle. All commands are available after installing with npm install -g squeezr-ai.

squeezr setup

One-time setup that configures everything automatically: env vars, shell wrapper, auto-start, and TLS certificates. Run once after installation.

squeezr setup

What it does:

• Sets ANTHROPIC_BASE_URL and GEMINI_API_BASE_URL in your user environment.
• Installs a shell wrapper in PowerShell $PROFILE (Windows) or ~/.bashrc / ~/.zshrc (Linux/macOS/WSL) that auto-refreshes env vars without restarting the terminal.
• Registers auto-start (Task Scheduler on Windows, systemd on Linux, launchd on macOS).
• Generates and installs the MITM CA certificate for Codex support.

squeezr start

Starts the proxy as a background daemon.

squeezr start

Starts both the HTTP proxy (port 8080) and the MITM proxy (port 8081). If a version mismatch is detected after an update, it restarts automatically with the correct binary.

squeezr stop

Stops the running proxy daemon.

squeezr stop

squeezr status

Shows whether the proxy is running, on which ports, and the PID.

squeezr status

squeezr update

Kills the running proxy, installs the latest version from npm, and restarts automatically. Also runs setup to refresh env vars and shell wrappers.

squeezr update

squeezr logs

Shows the last 50 log lines.

squeezr logs

squeezr config

Prints the current resolved configuration.

squeezr config

squeezr ports

Interactive prompt to change the HTTP proxy port and MITM proxy port. Updates env vars automatically.

squeezr ports

squeezr gain

Estimates token savings for a directory by analysing the files in it.

squeezr gain

squeezr discover

Detects which AI CLIs are installed on your system.

squeezr discover

squeezr uninstall

Removes everything Squeezr installed: env vars, CA certificates, auto-start entries, and log files. Run npm uninstall -g squeezr-ai afterwards to remove the package.

squeezr uninstall

squeezr version

Prints the installed version.

squeezr version

Command summary