단축명령 신설 — 사용량 / 캐시삭제

2026-08-15 · commands 등록 + CLAUDE.md 등록 완료 · 치트시트 위젯 자동 반영

🔴 먼저 정직하게 — 별칭이 아니라 "대응 구현"입니다

/usage/compact는 하네스가 직접 처리하는 내장 명령이라 단축명령으로는 호출이 불가능합니다(단축명령 = 모델에게 가는 프롬프트). 그래서 각각 같은 목적을 실제로 달성하는 동작으로 만들었습니다.

① 사용량 — /usage 대응

하는 일로컬 세션 기록을 스캔해 최근 5시간(세션 창 근사) / 7일(주간 창 근사) 토큰 사용량을 모델별 표로 출력
도구_도구_사용량조회\usage_report.py — 읽기 전용·오프라인
검증🟢 8/15 실측 성공 (7일간 opus-5 응답 664건, fable-5 580건 등 실데이터)
한계근사치. 공식 게이지·재설정 일시는 별도 터미널 claude/usage

② 캐시삭제 — /compact 대응

🔴 개념 교정 내장: /compact는 캐시 삭제가 아니라 대화 컨텍스트 압축(요약)입니다. 실행할 때마다 첫 줄에 고지합니다.

하는 일현재 세션의 인수인계 요약 md 생성 — 진행 상태·결정사항·미결·다음 액션·새 세션 첫 프롬프트 문안 → _보관\_retrospective\인수인계_일시.md
쓰는 때세션이 무거워졌을 때 → 캐시삭제새 대화를 열고 md 경로만 던지면 이어짐
안전파일 삭제 없음 · 요약은 사실만
참고터미널 CLI에선 내장 /compact 직접 입력 가능 · 데스크톱 대화는 자동 압축

사용법

사용량     ← 토큰 사용량 리포트
캐시삭제   ← 인수인계 요약 생성 + 새 세션 안내

둘 다 단독 입력일 때만 트리거. 문장 속 표현은 트리거 아님. 치트시트 위젯에 자동 표시.