sqz

sqz 概覽

這是什麼

sqz 是一個專為 AI 程式碼代理設計的上下文壓縮工具。它在工具輸出進入模型之前進行壓縮，並將重複內容去重為簡短參考（13 個 token）。此工具以 Rust 撰寫，完全不呼叫 LLM，可離線運作。專案託管於 ojuschugh1/sqz，與任何其他同名工具無關。

主要功能

• 注入前上下文壓縮：在工具輸出進入上下文視窗前進行壓縮。
• 會話去重：重複內容（例如未變更的 git status、相同的檔案行）以簡短參考取代完整內容。
• 每指令格式化器：保留代理關鍵事實（失敗測試、斷言、檔案:行號），捨棄不相關部分。
• 原始碼、堆疊追蹤與憑證行保持不變或永不快取。
• 單一 Rust 二進位檔，確定性，無 LLM 呼叫，可離線運作。
• sqz expand 可逐位元組還原壓縮結果（憑證、堆疊追蹤、遷移除外）。
• 支援 Claude Code、Cursor、Codex、Kiro、Zed 及任何 MCP 客戶端。

使用情境

• AI 程式碼代理將大部分輸入 token 花費在工具輸出（建置日誌、測試執行、git status、檔案讀取）。
• 在含有大量指令輸出與重複指令的會話中減少 token 用量。
• 壓縮 cargo test、git status、檔案讀取及 JSON 回應等指令的輸出。
• 可與任何 MCP 客戶端搭配使用，亦可作為 MCP 代理。

快速開始

sh cargo install sqz-cli sqz-mcp # 或：brew install ojuschugh1/sqz/sqz · npm i -g sqz-cli · pipx install sqz sqz init # 為找到的每個客戶端安裝鉤子、MCP 伺服器與代理指引 或使用預編譯二進位檔： sh # macOS / Linux curl -fsSL https://raw.githubusercontent.com/ojuschugh1/sqz/main/install.sh | sh # Windows (PowerShell) irm https://raw.githubusercontent.com/ojuschugh1/sqz/main/install.ps1 | iex # 任何平台（透過 npm） npm install -g sqz-cli # macOS / Linux（透過 Homebrew） brew tap ojuschugh1/sqz brew install sqz 安裝後執行 sqz init --global 或 sqz init 以設定鉤子。執行 sqz doctor 檢查完整鏈路。

授權與價格

採用 Apache-2.0 授權。開放原始碼。

內容整理自該專案公開的 README 與儲存庫資訊。