Config File Reference
Squeezr uses TOML for configuration. This page is the complete reference for every key in the config file, organized by section.
File locations
# Global config — next to the installed binary (in npm global prefix)
squeezr.toml
# Project config — deep-merged over global, apply per-repo overrides
.squeezr.toml (in your project root)Use squeezr config to print the resolved path and current values.
[proxy]
Controls the proxy server ports.
| Key | Type | Default | Description |
|---|---|---|---|
port | integer | 8080 | HTTP proxy port (Claude Code, Aider, Gemini CLI). |
mitm_port | integer | 8081 | MITM proxy port (Codex). Defaults to port + 1. |
[compression]
Controls how and when content is compressed.
| Key | Type | Default | Description |
|---|---|---|---|
threshold | integer | 800 | Minimum content size (chars) to trigger compression. |
keep_recent | integer | 3 | Last N tool results to leave uncompressed. |
compress_system_prompt | boolean | true | Compress and cache the system prompt. |
compress_conversation | boolean | false | Also compress assistant messages (aggressive mode). |
skip_tools | array | [] | Tool names to never compress (e.g. ["Read"]). |
only_tools | array | [] | Only compress these tools, skip all others (e.g. ["Bash"]). |
[cache]
Controls in-process caching of compressed results.
| Key | Type | Default | Description |
|---|---|---|---|
enabled | boolean | true | Enable the cache. |
max_entries | integer | 1000 | Maximum number of cached compressed results. |
[adaptive]
Adaptive pressure automatically increases compression aggressiveness as the context window fills up.
| Key | Type | Default | Description |
|---|---|---|---|
enabled | boolean | true | Enable adaptive compression. |
low_threshold | integer | 1500 | Min chars to compress when context is below 50%. |
mid_threshold | integer | 800 | Min chars to compress when context is 50–75%. |
high_threshold | integer | 400 | Min chars to compress when context is 75–90%. |
critical_threshold | integer | 150 | Min chars to compress when context exceeds 90%. Git diff context set to 0. |
[local]
Configuration for local model servers (Ollama) used as the compression backend.
| Key | Type | Default | Description |
|---|---|---|---|
enabled | boolean | true | Enable local model support. |
upstream_url | string | "http://localhost:11434" | URL of the local model server. |
compression_model | string | "qwen2.5-coder:1.5b" | Local model to use for AI compression. |
Full example
# squeezr.toml
[proxy]
port = 8080
mitm_port = 8081
[compression]
threshold = 800
keep_recent = 3
compress_system_prompt = true
compress_conversation = false
# skip_tools = ["Read"]
# only_tools = ["Bash"]
[cache]
enabled = true
max_entries = 1000
[adaptive]
enabled = true
low_threshold = 1500
mid_threshold = 800
high_threshold = 400
critical_threshold = 150
[local]
enabled = true
upstream_url = "http://localhost:11434"
compression_model = "qwen2.5-coder:1.5b"