Gemini 사용자를 위한 CV2601 커뮤니티 기능 셋업 및 사용 가이드
이 문서는 개인 볼트(keen-bridge)와 커뮤니티 볼트(CV2601)를 Gemini CLI 환경에서 연동하고 사용하는 방법을 설명합니다.
여기비디오에서도 같은 내용을 보실 수 있습니다: https://youtu.be/MkskR7ZKqKk
1. 사전 준비 (Prerequisites)
로컬 환경에 두 개의 볼트가 모두 존재해야 합니다.
- 개인 볼트: 예)
/Users/lifidea/Vaults/keen-bridge - 커뮤니티 볼트: 예)
/Users/lifidea/Vaults/CV2601
2. Gemini 실행 환경 구성 (Multi-vault Context)
커뮤니티 기능을 원활하게 사용하기 위해서는 Gemini가 개인 볼트와 커뮤니티 볼트의 내용을 동시에 인식할 수 있어야 합니다.
실행 명령어
개인 볼트 경로에서 다음 명령어로 Gemini를 실행합니다:
gemini --include-directories=/Users/lifidea/Vaults/CV2601
편의를 위한 Alias 설정
매번 경로를 입력하는 번거로움을 줄이기 위해 단축 명령어(Alias)를 설정하는 것을 권장합니다.
macOS/Linux (zsh/bash)
.zshrc 또는 .bashrc 파일에 추가:
alias gemini-cv="gemini --include-directories=/Users/lifidea/Vaults/CV2601"
Windows (PowerShell)
PowerShell 프로필($PROFILE)에 함수 추가:
function gemini-cv { gemini --include-directories=/Users/lifidea/Vaults/CV2601 $args }
3. 커뮤니티 기능 설치 (ICF)
최초 1회, 개인 볼트에서 설치 프롬프트를 실행하여 환경을 구성합니다.
실행 방법
반드시 개인 볼트에서 실행해야 하며, CV2601에 있는 설치 프롬프트를 호출합니다.
Run @../CV2601/_Settings_/Prompts/Install Community Feature (ICF).md
설치되는 항목들
- 필수 디렉토리 생성:
_Outbox_/Community/: 작성된 질문이나 답변의 초안이 저장되는 곳Ingest/Community/: 커뮤니티 업데이트를 가져오는 곳
- 프롬프트 복사:
ACQ(질문하기),ANQ(답변하기),CPU(프로필 업데이트),CUP(업데이트 가져오기) 등이 개인 볼트의_Settings_/Prompts/로 복사됩니다.
- 보안 설정 (
VAULTS.md):- 커뮤니티 프롬프트가 개인 볼트의 민감한 정보(Journal, Personal 등)를 읽지 못하도록 차단 규칙(Blacklist)을 생성합니다.
4. 커뮤니티 활동하기
질문하기 (ACQ: Ask Community Question)
설치가 완료되면 로컬에 복사된 ACQ 프롬프트를 사용하여 질문을 작성할 수 있습니다.
- 명령어 실행:
Run ACQ -- 제미나이와 클로드 코드의 차이점이 뭔가요? - 초안 생성 및 검토:
- Gemini가 개인 볼트의 관련 노트(
Background)를 참고하여 질문 초안을 작성합니다. - 저장 위치:
_Outbox_/Community/YYYY-MM-DD-slug-draft.md
- Gemini가 개인 볼트의 관련 노트(
- 커뮤니티 배포 (Push):
- 초안 내용이 마음에 들면 Gemini에게 "Push it"이라고 지시합니다.
- Gemini가 파일을
CV2601/Questions/폴더로 복사하고, 로컬 파일명을 변경하여 배포 완료를 표시합니다.
기타 명령어
- ANQ (Answer Community Question): 올라온 질문에 답변을 작성합니다.
- CUP (Community Update Pull): 커뮤니티의 최신 소식을 가져옵니다.
- CPU (Community Profile Update): 커뮤니티 볼트의 내 프로필 정보를 업데이트합니다.
5. 주의사항
- 개인 정보 보호:
VAULTS.md파일이 삭제되지 않도록 주의하세요. 이 파일은 커뮤니티 기능이 개인적인 일기나 비밀번호 등을 읽지 못하게 막아주는 중요한 역할을 합니다. - 경로: 모든 커뮤니티 관련 명령어는 개인 볼트 루트에서 실행하는 것을 원칙으로 합니다.