AI 파일이 내 레포를 망치는 게 지겨워서 — 그래서 이 CLI를 만들었어요

Source: Dev.to

문제

코딩 중에 AI 도구를 사용하면 다양한 임시 파일이나 AI가 생성한 파일들이 프로젝트에 쌓이게 됩니다:

notes.md
final-notes.md
prompt-final-final.md
temp.md

이 파일들은 유용할 수 있지만, 저장소에 포함될 필요는 없습니다. 무시하면 레포가 지저분해지고, 커밋하면 히스토리가 어수선해집니다. 결과적으로 잡음이 많은 저장소가 되거나 유용한 메모를 잃게 됩니다.

ccv (Claude Code Vault) 소개

ccv는 모든 개인 AI 관련 파일을 저장소 외부의 단일 금고에 보관하는 작은 CLI 도구입니다.

• 저장소와 무관한 저장소: ~/.ccv/
• 프로젝트별 하위 폴더: ~/.ccv/projects/<project-name>/
• 프로젝트 내부에서 심볼릭 링크를 통한 투명한 접근

예시 레이아웃

.project-docs/notes.md → ~/.ccv/projects/my-project/notes.md

기능

• 별도 저장 AI가 만든 메모, 프롬프트 모음, 디버깅 실험, 아키텍처 초안 등을 위한 공간
• 유용한 파일은 모두 보관하면서 저장소를 깔끔하게 유지
• 여러 프로젝트에서 동시에 사용 가능
• 파일은 로컬에 남아 있으며 필요하면 Git으로 버전 관리 가능
• 간단한 명령어 집합:

# 현재 프로젝트에 대한 금고 초기화
ccv init

# 파일을 금고에 추가 (프로젝트에 심볼릭 링크 생성)
ccv add notes.md

# 금고에 변경 사항 푸시 (선택적 동기화 단계)
ccv push

왜 도움이 되는가

• 워크플로우에서 지속적인 불편 요소를 제거
• 실제 코드와 보조 AI 파일을 명확히 구분
• AI 도구(Claude 등)가 파일을 읽을 수 있지만, 저장소에 포함되지 않음

시작하기

• Repository:
• 무료 사용 가능

도구가 시간을 절약하거나 워크플로우를 개선한다면, 저자를 지원해 보세요:

---

특별한 기능은 없고, 일상적인 워크플로우를 더 깔끔하게 유지하기 위한 실용적인 방법일 뿐입니다.