lowfat은 에이전트(agent)에 도달하기 전 불필요한 CLI 출력을 필터링하여 AI 토큰 비용을 줄여주는 경량 CLI 도구입니다.

핵심 집중 사항 (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   # 또는 ~/.bashrc

OpenCode 플러그인 (plugin) — 설정 편집 없이 명령어 하나로 설치:

lowfat opencode install   # ~/.config/opencode/plugins/lowfat.ts 에 작성됨

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                       # 상태 배지 + 활성 필터 (active filters)
lowfat info git                   # `git`을 위한 파이프라인 (pipeline)
...

더 알아보기 (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)

• rtk
• context-mode
• lean-ctx
• tokf
• tamp
• ecotokens
• token-enhancer

라이선스 (License)

Apache-2.0

AI 고지 (AI notice)

이 프로젝트에는 여러 AI 도구가 사용되었습니다.