Skillget

squeez

skill
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Gecti
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This tool provides token compression and context memory management for AI coding assistants like Claude Code and GitHub Copilot CLI. It intercepts bash commands to reduce output noise, tracks token usage across sessions, and automatically alerts when context limits are approaching.

Security Assessment
Overall risk: Low. The tool operates by intercepting and rewriting shell commands, which inherently requires reading terminal output. It does not request dangerous permissions, and a static code scan of 12 files found no hardcoded secrets, malicious patterns, or dangerous behaviors. The installation relies on piping a remote shell script to `sh` (`curl | sh`), which is standard practice for many open-source Rust projects but still warrants a manual review of the `install.sh` script before running. There are no indications of unauthorized network requests or data exfiltration.

Quality Assessment
Quality appears solid but comes with caveats regarding community adoption. The project is actively maintained (last updated today), uses the permissive MIT license, and features continuous integration tests along with detailed benchmarks. However, it currently has extremely low visibility with only 5 GitHub stars. Because it is a niche, low-visibility project, it has not been battle-tested by a broad audience. The clear documentation and configuration options demonstrate good development hygiene.

Verdict
Safe to use, though you should inspect the `install.sh` script before executing it due to the project's low community visibility.
SUMMARY

Token compression + context memory for Claude Code etc. Runs automatically. No configuration required.

README.md

squeez

CI
License: MIT
Rust

Token compression + context optimization for Claude Code, OpenCode, and GitHub Copilot CLI. Runs automatically in Claude Code and Copilot CLI. Manual usage in OpenCode.

What it does

  • Bash compression — intercepts every command, removes noise, up to 95% token reduction
  • Session memory — injects a summary of prior sessions at session start
  • Token tracking — tracks context usage across all tool calls
  • Compact warning — alerts when session approaches context limit (80% of budget)

Install

Windows users: squeez requires Git Bash to run. PowerShell and CMD are not supported — the hooks and binary rely on a POSIX shell environment. Open Git Bash and run:

curl -fsSL https://raw.githubusercontent.com/claudioemmanuel/squeez/main/install.sh | sh
  • Claude Code: Restart Claude Code to activate
  • OpenCode: Restart OpenCode to activate the plugin
  • Copilot CLI: Memory injected into ~/.copilot/copilot-instructions.md; restart Copilot CLI to activate hook-based bash compression

Benchmarks

Measured on macOS (Apple Silicon), token estimate = chars/4. Run with bash bench/run.sh.

Fixture Before After Reduction Latency
ps aux 40,373 tk 2,352 tk -95% 6ms
git log (200 commits) 2,667 tk 819 tk -70% 4ms
docker logs 665 tk 186 tk -73% 5ms
find (deep tree) 424 tk 134 tk -69% 3ms
git status 50 tk 16 tk -68% 3ms
ls -la 1,782 tk 886 tk -51% 4ms
npm install 524 tk 231 tk -56% 3ms
git diff 502 tk 317 tk -37% 4ms
env dump 441 tk 287 tk -35% 3ms
Copilot CLI session 639 tk 421 tk -35% 3ms

10/10 fixtures pass. Latency under 10ms on every fixture.

Escape hatch

--no-squeez git log --all --graph

Configuration

Optional config file (all fields optional):

  • Claude Code / default: ~/.claude/squeez/config.ini
  • Copilot CLI: ~/.copilot/squeez/config.ini
# Compression
max_lines = 200
dedup_min = 3
git_log_max_commits = 20
docker_logs_max_lines = 100
bypass = docker exec, psql, ssh

# Session memory
compact_threshold_tokens = 160000   # warn at 80% of context budget
memory_retention_days = 30          # how long to keep session summaries

How it works

Claude Code & Copilot CLI

Three hooks work together:

Compression (PreToolUse): Every Bash call is rewritten — git status → squeez wrap git status. The wrap command runs via sh -c, captures stdout+stderr, applies 4 strategies (smart_filter → dedup → grouping → truncation), and prints a compressed result with a savings header.

Session memory (SessionStart): On each new session, squeez init finalizes the previous session into a summary (files touched, errors resolved, test results, git events) and prints a memory banner so the agent has prior-session context from the start. For Copilot CLI, this banner is also written to ~/.copilot/copilot-instructions.md which is loaded automatically at every session.

Token tracking (PostToolUse): Every tool call's output size is tracked. When cumulative session tokens cross 80% of the context budget, a compact warning is emitted in the next bash output header.

OpenCode

OpenCode is supported via an auto-loading plugin that intercepts all Bash commands.

Install:

curl -fsSL https://raw.githubusercontent.com/claudioemmanuel/squeez/main/install.sh | sh

What happens:

  • Plugin is installed to ~/.config/opencode/plugins/squeez.js
  • OpenCode auto-loads plugins on startup
  • All Bash commands are automatically compressed via squeez wrap

Escape hatch:

--no-squeez git log --all --graph

Manual usage:

squeez wrap git status
squeez wrap docker logs mycontainer
squeez wrap npm install

GitHub Copilot CLI

Copilot CLI is supported via hooks registered in ~/.copilot/settings.json and session memory injected into ~/.copilot/copilot-instructions.md.

Install:

curl -fsSL https://raw.githubusercontent.com/claudioemmanuel/squeez/main/install.sh | sh

What happens:

  • Session memory is written to ~/.copilot/copilot-instructions.md — Copilot CLI reads this automatically at every session start, giving the agent prior-session context without re-discovery tokens
  • Hooks are registered in ~/.copilot/settings.json for PreToolUse (bash compression), SessionStart (memory refresh), and PostToolUse (token tracking)
  • Session state is stored separately in ~/.copilot/squeez/ (independent from Claude Code state)

Refresh memory manually:

SQUEEZ_DIR=~/.copilot/squeez ~/.claude/squeez/bin/squeez init --copilot

Escape hatch:

--no-squeez git log --all --graph

Local development

Prerequisites: Rust stable, bash (Git Bash on Windows — PowerShell is not supported). Works on Windows (Git Bash), macOS, and Linux.

Install Rust via rustup:

# macOS / Linux
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Windows: download and run rustup-init.exe from https://rust-lang.org/tools/install/
# Then restart your terminal so cargo is in PATH.
# Windows users also need MSVC C++ Build Tools:
# https://visualstudio.microsoft.com/visual-cpp-build-tools/

# 1. Clone
git clone https://github.com/claudioemmanuel/squeez.git
cd squeez

# 2. Build & test
cargo test

# 3. Run benchmarks (uses local release binary automatically)
cargo build --release
bash bench/run.sh

# 4. Install hooks into Claude Code and Copilot CLI config
bash install.sh

# 5. Restart Claude Code / Copilot CLI — squeez is active

To uninstall: bash uninstall.sh

Contributing

See CONTRIBUTING.md.

Yorumlar (0)

Sonuc bulunamadi