squeez
Hook-based token compressor for 5 AI CLI hosts (Claude Code, Copilot CLI, OpenCode, Gemini CLI, Codex CLI). Up to 95% bash compression, signature-mode for code reads, cross-call dedup, MCP server, self-teaching protocol. Zero runtime deps.
File Explorer
Download Latest Version (.zip)- bug_report.yml
- config.yml
- feature_request.yml
- improvement.yml
- generate-changelog.sh
- release-notes.sh
- update-readme-benchmarks.sh
- auto-release.yml
- ci.yml
- cleanup-branches.yml
- dco.yml
- no-claude-trailer.yml
- pr-checks.yml
- promote-to-main.yml
- release.yml
- FUNDING.yml
- pull_request_template.md
- post-tool-use.js
- session-start.js
- stop.js
- art.js
- engine.js
- hud.js
- squeez.js
- state.js
- usage.js
- statusline.js
- art.test.js
- engine.test.js
- hud.test.js
- squeez.test.js
- usage.test.js
- xp.test.js
- buddy-cli.js
- banner.png
- buddy-command.md
- filters_builtin.ini
- focus_adhd.md
- focus_adhd_pt_br.md
- persona_full.md
- persona_full_pt_br.md
- persona_lite.md
- persona_ultra.md
- persona_ultra_pt_br.md
- squeez-command.md
- bundle_install.txt
- cargo_build.txt
- cat_claude_md.txt
- context_crosscall_1.txt
- context_crosscall_2.txt
- context_crosscall_3.txt
- docker_logs.txt
- env_dump.txt
- find_deep.txt
- git_copilot_session.txt
- git_diff.txt
- git_log_200.txt
- git_status.txt
- intensity_budget80.txt
- kubectl_pods.txt
- ls_la.txt
- mdcompress_claude_md.txt
- mdcompress_en_prose.txt
- mdcompress_prose.txt
- mdcompress_ptbr_prose.txt
- mypy_errors.txt
- npm_install.txt
- pip_install.txt
- ps_aux.txt
- repetitive.txt
- rsync_transfer.txt
- shellcheck_findings.txt
- summarize_huge.txt
- systemctl_status.txt
- tsc_errors.txt
- verbose_log.txt
- xcodebuild_build.txt
- bench_i18n.rs
- benchmark_report.json
- capture.sh
- marginal_snapshot.json
- report.md
- run.sh
- run_context.sh
- substitutions_snapshot.json
- verify_tokens.json
- verify_tokens.py
- codex-posttooluse.sh
- codex-pretooluse.sh
- codex-session-start.sh
- copilot-posttooluse.sh
- copilot-pretooluse.sh
- copilot-session-start.sh
- gemini-after-tool.sh
- gemini-before-tool.sh
- gemini-session-start.sh
- pi-extension.ts
- postcompact.sh
- posttooluse.sh
- precompact.sh
- pretooluse.sh
- session-start.sh
- statusline.sh
- subagent-stop.sh
- .npmignore
- bin.js
- CHANGELOG.md
- install.js
- package.json
- squeez.js
- __init__.py
- plugin.yaml
- analyze_transcript.py
- statusline.sh
- README.md
- userpromptexpansion-spike.sh
- en.rs
- mod.rs
- pt_br.rs
- locale.rs
- mod.rs
- cargo_test.rs
- eslint_json.rs
- git_status.rs
- go_test_ndjson.rs
- jest_json.rs
- mod.rs
- pytest.rs
- ruff_json.rs
- benchmark.rs
- build.rs
- cloud.rs
- compact.rs
- compress_output.rs
- compress_prompt.rs
- config_cmd.rs
- data_tool.rs
- database.rs
- discover.rs
- docker.rs
- doctor.rs
- filter_stdin.rs
- flag_force.rs
- focus.rs
- fs.rs
- generic.rs
- git.rs
- init.rs
- mcp_server.rs
- mod.rs
- network.rs
- next_build.rs
- package_mgr.rs
- persona.rs
- playwright.rs
- protocol.rs
- prune.rs
- runtime.rs
- setup.rs
- test_runner.rs
- text_proc.rs
- track.rs
- track_result.rs
- typescript.rs
- uninstall.rs
- update.rs
- wrangler.rs
- wrap.rs
- cache.rs
- factsheet.rs
- hash.rs
- intensity.rs
- mod.rs
- redundancy.rs
- retrieve.rs
- sensitive.rs
- stash_index.rs
- summarize.rs
- transcript.rs
- agent_tracker.rs
- budget.rs
- burn_rate.rs
- calibrate.rs
- efficiency.rs
- enterprise.rs
- handler_stats.rs
- mod.rs
- nudge.rs
- preservation.rs
- buddy.rs
- claude_code.rs
- codex.rs
- copilot.rs
- gemini.rs
- hermes.rs
- memory_size.rs
- mod.rs
- opencode.rs
- pi.rs
- settings_json.rs
- dedup.rs
- grouping.rs
- log_template.rs
- mod.rs
- smart_filter.rs
- success_collapse.rs
- toon.rs
- truncation.rs
- config.rs
- filter.rs
- filter_dsl.rs
- json_util.rs
- lib.rs
- main.rs
- memory.rs
- session.rs
- tokens.rs
- test_agent_burst.rs
- test_agent_compress_output.rs
- test_agent_guard.rs
- test_agent_measurement.rs
- test_amplification.rs
- test_benchmark_hypothesis.rs
- test_build.rs
- test_builtin_filters.rs
- test_cache_stability.rs
- test_call_rate_spike.rs
- test_cloud.rs
- test_compress_md.rs
- test_compress_md_i18n.rs
- test_compress_md_skills.rs
- test_compress_output.rs
- test_compress_output_skill.rs
- test_compress_prompt.rs
- test_config.rs
- test_config_cmd.rs
- test_config_tunables.rs
- test_context_cache.rs
- test_cross_agent_dedup.rs
- test_database.rs
- test_dedup.rs
- test_dispatch_cloudflare.rs
- test_docker.rs
- test_doctor.rs
- test_efficiency_proof.rs
- test_emission_guard.rs
- test_error_snippets.rs
- test_factsheet.rs
- test_file_access_types.rs
- test_filter_dispatch.rs
- test_filter_dsl_integration.rs
- test_flag_force.rs
- test_focus.rs
- test_fs.rs
- test_generic.rs
- test_git.rs
- test_grouping.rs
- test_handler_stats.rs
- test_hook_scripts.rs
- test_hosts_buddy.rs
- test_hosts_claude_code.rs
- test_hosts_codex.rs
- test_hosts_gemini.rs
- test_hosts_opencode.rs
- test_hosts_pi.rs
- test_hosts_registry.rs
- test_hosts_windows_paths.rs
- test_idle_guard.rs
- test_init.rs
- test_intensity.rs
- test_json_util.rs
- test_loop_nudges.rs
- test_mcp_server.rs
- test_memory.rs
- test_memory_file_warn.rs
- test_memory_fixes.rs
- test_memory_structured.rs
- test_network.rs
- test_next_build.rs
- test_nudge.rs
- test_package_mgr.rs
- test_persona.rs
- test_plan_mode.rs
- test_playwright.rs
- test_prune.rs
- test_read_dedup.rs
- test_redundancy.rs
- test_redundancy_shingle.rs
- test_repro_mcp_fuzzy.rs
- test_runtime.rs
- test_sensitive.rs
- test_sensitive_path_warning.rs
- test_session.rs
- test_session_stats.rs
- test_sig_mode.rs
- test_smart_filter.rs
- test_success_collapse.rs
- test_summarize.rs
- test_summary_structured.rs
- test_test_runner.rs
- test_track.rs
- test_track_result.rs
- test_truncation.rs
- test_typescript.rs
- test_update.rs
- test_wrangler.rs
- test_wrap_integration.rs
- .gitattributes
- .gitignore
- build.sh
- Cargo.lock
- Cargo.toml
- CHANGELOG.md
- CLAUDE.md
- CONTRIBUTING.md
- install.sh
- LICENSE
- NOTICE
- README.md
- SECURITY.md
- uninstall.sh
# Installation Guide
1. Get the code
git clone https://github.com/claudioemmanuel/squeez
Downloads the entire project code from GitHub to your computer.
cd squeez
Moves into the project folder you just downloaded.
2. Official Install Script
Easy RecommendedPrerequisites
- Node.js Node.js must be installed to use npm.
- Rust (rustup) Rust is required to use cargo.
- Python 3 Python is required to use pip.
curl -fsSL https://raw.githubusercontent.com/claudioemmanuel/squeez/main/install.sh | sh
Downloads and runs the official install script in one line β this handles the full setup automatically.
npm install -g squeez
Installs the package published on the npm registry globally β no need to clone the source.
cargo install squeez
Builds and installs the package published on crates.io β no need to clone the repo yourself.
pip install tiktoken
Installs the package published on PyPI directly β no need to clone the source.
After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.
Pulled directly from this repo's README.
3. Node.js
EasyPrerequisites
npm install -g squeez
Installs the package published on the npm registry globally β no need to clone the source.
After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.
Pulled directly from this repo's README.
4. Rust
MediumPrerequisites
- Git Needed to download the project code from GitHub.
- Rust (rustup) Installing via rustup also installs cargo.
cargo install squeez
Builds and installs the package published on crates.io β no need to clone the repo yourself.
cargo build --release
Compiles the Rust project.
cargo test # run all tests (356 tests, 37 suites)
Type this command into your terminal and run it.
cargo build --release # build release binary
Compiles the Rust project.
cargo test
Type this command into your terminal and run it.
If cargo build finishes without errors, it worked. The executable is created under target/.
Pulled directly from this repo's README.
// repository documentation
Was this content helpful?
(0 ratings)