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 에이전트 환경을 위한 즉시 사용 가능한 훅을 제공합니다.