<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./docs/lowfat_logo_dark.svg">
<img src="https://raw.githubusercontent.com/zdk/lowfat/HEAD/docs/lowfat_logo_light.svg" alt="lowfat logo" width="700">
</picture>
</p>
lowfat은 에이전트(agent)에 도달하기 전 불필요한 CLI 출력을 필터링하여 AI 토큰 비용을 줄여주는 경량 CLI 도구입니다.
<p align="center">
<img src="https://raw.githubusercontent.com/zdk/lowfat/HEAD/docs/demo.gif" alt="lowfat demo: git diff before and after" width="700">
</p>
핵심 집중 사항 (Core focus)
- 경량성 (Lightweight) — 작고 단일한 바이너리(binary), 작은 코어(core)를 가지지만 확장 가능합니다.
- 로컬 우선 (Local-first) — 텔레메트리(telemetry)가 없으며, 데이터의 소유권은 사용자에게 있습니다.
- 조합 가능성 (Composable) — UNIX 스타일의 파이프(pipes)를 사용하여 내장 기능과 사용자 정의 필터를 혼합할 수 있습니다. 마법 같은 방식이 아닙니다.
- 사용자 소유 (User-owned) —
lowfat history를 통해 가장 자주 실행하는 명령을 확인할 수 있으며, 사용자의 사용 사례(usecase)에 맞춰 커스터마이징할 수 있습니다.
설치 (Install)
cargo install lowfat
brew install zdk/tools/lowfat
GitHub Releases에서 미리 빌드된 바이너리(binaries)를 받을 수 있습니다.
설정 (Setup)
다음 중 하나를 선택하세요:
Claude Code 훅 (hook) — .claude/settings.json에 추가:
{
"hooks": {
"PreToolUse": [
...
셸 통합 (Shell integration) — 에이전트 환경(CLAUDECODE=1, CODEX_ENV) 내에서 자동 활성화되거나, LOWFAT_ENABLE=1을 설정하여 모든 셸에서 강제로 활성화할 수 있습니다:
echo 'eval "$(lowfat shell-init zsh)"' >> ~/.zshrc
OpenCode 플러그인 (plugin) — 설정 편집 없이 명령어 하나로 설치:
OpenCode를 재시작하세요. 명령어가 실행되기 전에 투명하게 재작성됩니다.
lowfat opencode uninstall로 언제든지 제거할 수 있습니다.
직접 사용 (Direct usage) — 모든 명령어 앞에 접두사(prefix)를 붙입니다:
lowfat git status
lowfat docker ps
lowfat ls -la
Pi 에이전트 (Pi agent) — ~/.pi/agent/settings.json에서:
{ "shellCommandPrefix": "eval \"$(lowfat shell-init zsh)\"; " }
사용 하이라이트 (Usage highlights)
lowfat info
lowfat info git
...
더 알아보기 (Learn more)
- docs/ARCHITECTURE.md — 상위 수준 다이어그램 (high-level diagram): CLI, Runner, Plugins, Builtins
- docs/CONFIG.md —
.lowfat 파일, 환경 변수 (env vars), 파이프라인 DSL (pipeline DSL), 내장 프로세서 (built-in processors), history 랭킹 (ranking)
- docs/PLUGINS.md — lf-filter (.lf 플러그인 DSL), 쉘 탈출구 (shell escape hatches), PEP 723 + uv, AI 에이전트 프롬프트 (AI agent prompt)
대안 (Alternatives)
라이선스 (License)
Apache-2.0
AI 고지 (AI notice)
이 프로젝트에는 여러 AI 도구가 사용되었습니다.