zdk/lowfat

lowfat - slim your command output. strips noise, saves tokens.

What it solves

lowfat 旨在透過在 CLI 輸出與檔案內容送到 AI 代理之前過濾噪音，減少 AI 代幣成本與上下文視窗使用量。它可防止代理被冗長的日誌、重複的 git status 訊息或龐大的 lock 檔案淹沒，確保代理只收到必要的訊號。

How it works

它作為輕量級的 CLI 工具，可透過 shell hook、外掛或直接指令前綴整合至代理環境。它使用一系列過濾器處理常見指令（如 git、docker、ls、find）的輸出，並能在讀取檔案時壓縮內容。

過濾等級可透過 LOWFAT_LEVEL 環境變數（lite、full、ultra）調整，讓使用者在資料遺失與代幣節省之間取得平衡。

Who it’s for

使用 AI 代理（如 Claude Code、OpenCode 或 Pi）的開發者，想降低 API 成本並透過最佳化提供給 LLM 的上下文來提升代理效能。

Highlights

  • Token Reduction: 大幅減少 git diff、git log 等常見指令的輸出大小（部分情況可減少 90% 以上）。
  • File Compression: post-read hook 會剔除註解、正規化空白，並摘要 lock 檔或折疊原始碼中的函式本體。
  • Extensible: 支援透過專屬的 .lf DSL、shell 腳本或 Python（PEP 723/uv）自訂過濾器。
  • Local-first: 無遙測，完全在本機運作以確保資料隱私。
  • Integration: 為 Claude Code、OpenCode 與 Pi 代理環境提供即用的 hook。