Governor는 단순한 스타일 압축을 넘어 토큰 및 컨텍스트 블로트를 해결하는 Claude Code 플러그인입니다. 출력 토큰을 줄이고, CLAUDE.md와 같은 반복 메모리 파일을 압축하며, 시끄러운 빌드/테스트 로그를 필터링하고, 범위 이탈을 방지하기 위한 계획 가드레일을 추가합니다. Claude Code 플러그인으로 설치되며, /governor:* 명령 네임스페이스를 노출합니다.

빠른 시작

bash install.sh --force

Claude Code를 재시작한 후, 다음을 실행하세요:

/governor:status
/governor:audit
/governor:compress CLAUDE.md

Governor는 자동으로 간결한 전문 모드로 시작합니다. /governor:on 및 /governor:off로 전환할 수 있습니다.

벤치마크

Sonnet을 사용한 소규모 로컬 벤치마크 (비대화형, 도구 미사용):

• 출력 토큰 (세 가지 기술 프롬프트): 제어군 평균 989 토큰 → Governor 평균 440 토큰 (55.5% 절감). 무뚝뚝한 스타일은 44.9% 절감.
• 메모리 압축: 1877 토큰 파일 → 838 토큰 (55.4% 절감) 중간 압축 기준.
• 도구 출력 필터링: 합성 pytest -vv 시끄러운 출력 54,314 예상 토큰 → 1,726 토큰 (96.8% 차단) 실패 라인 보존.

주요 기능

• 항상 켜진 간결 모드: SessionStart 및 UserPromptSubmit 훅을 통해.
• 전문 메모리 압축: /governor:compress CLAUDE.md가 장황한 파일을 코드 블록, 인라인 코드, 경로, URL, 제목, 표, 경고, 환경 변수는 보존하며 다시 작성합니다. 품질 가드가 낮은 절감률 압축을 거부하고 백업을 복원합니다.
• 도구 출력 필터링: 시끄러운 Bash/테스트/빌드 출력을 요약하지만 실패 신호는 보존.
• 텔레메트리 원장: /governor:status가 차단된 토큰, 실패, 압축을 보고.
• 프롬프트 가이드: 모호한 광범위한 프롬프트에 대한 부드러운 제안.
• 계획 및 표류 방지: /governor:plan이 구현 계약을 생성; /governor:guard가 현재 변경 사항을 확인.
• 휴대용 규칙 스니펫: 간결 모드 규칙이 Codex, Gemini, Cursor, Windsurf, Cline에 포함됨.

명령어

• /governor:on / /governor:off – 응답 압축 활성화/비활성화
• /governor:status – 사용 대시보드 및 낭비 히트맵
• /governor:audit – 부풀려진 메모리/규칙 파일 찾기
• /governor:compress CLAUDE.md – 메모리 파일 압축
• /governor:full – 다음 Bash 명령어가 전체 출력 반환
• /governor:plan / /governor:guard – 범위 관리
• /governor:benchmark – 벤치마크 결과 설명

설치

# 로컬 개발
claude --plugin-dir .

한 줄 로컬 설치
bash install.sh --force
저장소에서
gh repo clone 0xhimanshu/governor
cd governor
bash install.sh --force

컨텍스트 블로트, 광범위한 작업 이탈, 또는 할당량을 잡아먹는 시끄러운 로그로 어려움을 겪는 헤비 Claude Code 사용자는 Governor를 시도해보세요. 스타일 전용 토큰 절감 도구에 대한 진지한 대안입니다.