zdk/lowfat

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。