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 ツールとして、シェルフック、プラグイン、またはコマンドのプレフィックス付与でエージェント環境に組み込むことができます。git、docker、ls、find などの一般的なコマンドの出力を処理するフィルターパイプラインを使用し、読み取り時にファイル内容を圧縮することも可能です。

フィルターレベルは LOWFAT_LEVEL 環境変数（lite、full、ultra）で調整でき、データ損失とトークン節約のバランスを選択できます。

Who it’s for

Claude Code、OpenCode、Pi などの AI エージェントを使用する開発者で、API コストを下げ、LLM に提供するコンテキストを最適化してエージェントのパフォーマンスを向上させたい方に最適です。

Highlights

  • Token Reduction: git diff や git log などの一般的なコマンドの出力サイズを大幅に削減（ケースによっては 90% 超）。
  • File Compression: post-read フックはコメントを除去し、空白を正規化し、lock ファイルを要約したり、ソースコードの関数本体を折りたたんだりします。
  • Extensible: 専用の .lf DSL、シェルスクリプト、または Python（PEP 723/uv）でカスタムフィルタをサポート。
  • Local-first: テレメトリなしで完全にローカル実行、データプライバシーを確保。
  • Integration: Claude Code、OpenCode、Pi エージェント環境向けの即用フックを提供。