terminal-wits은(는) 무엇을 하나요?
AI 코드 위생 2026: 최고의 저장소 정리 및 커밋 가드 도구
개요
terminal-wits는 저장소의 코드 위생 상태를 자동으로 점검하고 유지하기 위한 도구 모음입니다. AI 기반 개발 환경(Claude Code, Cursor, Codex 등)과 함께 사용할 수 있도록 설계되었습니다.
주요 기능
- 저장소 정리(Repo Cleanup): 불필요한 파일(임시 파일, 캐시, 로그, 중복 자료 등)을 탐지하고 제거합니다.
- 커밋 가드(Commit Guard): 커밋 전에 코드 스타일, 보안 취약점, 파일 크기 등을 검사하여 문제가 있는 커밋을 차단합니다.
- Git 훅 통합:
pre-commit,commit-msg훅과의 원활한 통합을 지원합니다.
사용 방법
저장소 정리 실행
python cleanup.py --path ./my-repo --dry-run
--dry-run 옵션을 사용하면 실제로 파일을 삭제하지 않고 예상 결과만 출력합니다.
커밋 가드 활성화
python commit_guard.py --install
위 명령어로 Git 훅을 설치합니다. 이후 git commit 실행 시 자동으로 검사가 수행됩니다.
지원 환경
- 운영 체제: Linux, macOS, WSL (Windows)
- Python: 3.8 이상
- Git: 2.20 이상
의존성
gitpython(Python 라이브러리)pre-commit(선택 사항, Git 훅 관리)
설정
config.yaml 파일을 통해 제외할 파일 패턴, 검사 강도 등을 설정할 수 있습니다.
cleanup:
exclude_patterns:
- "*.pyc"
- "__pycache__"
commit_guard:
max_file_size_mb: 50
allowed_extensions:
- ".py"
- ".js"
- ".md"
라이선스
MIT