ONEDEV

claude-brain

AI MemoryskillShell

★ 89주당 +1조회 4

무엇인가

claude-brain은 Claude Code가 로컬 `~/.claude/`에 축적하는 뇌 상태(brain state)를 여러 장비 사이에서 하나로 수렴시키는 절차를 정의한다. 코드 작성 규칙 자체를 주입하는 스킬이 아니라, 메모리 항목·스킬 파일·에이전트 정의·규칙 파일·설정이 장비마다 분기되어 서로 다른 지식을 학습한 상태로 남는 문제 영역을 규율한다. 동기화 단위는 개별 파일이 아니라 저장소 전체 스냅샷이며, 각 장비는 독립적으로 병합을 수행한다.

어떻게 동작하나

동작은 훅과 슬래시 명령 두 축으로 나뉜다. `SessionStart`/`SessionEnd` 훅이 `git`을 호출해 `~/.claude/`를 읽고 쓰며, 사용자는 `/brain-init`, `/brain-join`, `/brain-status`, `/brain-share`로 초기화·합류·상태 확인·팀 공유를 수행한다. 병합 전략은 데이터 성격에 따라 갈린다. 설정·키바인딩·MCP 구성 같은 구조화 데이터는 결정적 JSON 딥머지로 무료 처리하고, 메모리와 `CLAUDE.md` 같은 비구조화 데이터는 `claude -p`를 통한 LLM 의미 병합으로 중복을 제거한다. 7일 주기로 실행되는 auto-evolve 분석은 반복적으로 안정된 메모리 패턴을 신뢰도 0.9 이상일 때 영구 설정으로 승격시킨다.

무엇과 다른가

수동으로 `CLAUDE.md`를 복사하거나 dotfiles 저장소에 `~/.claude/`를 넣는 방식과 구조적으로 다르다. 후자는 파일 단위 덮어쓰기이므로 양쪽 장비에서 갱신된 내용 중 한쪽이 유실되지만, 이 플러그인은 N-way 병합을 전제로 세 장비 이상이 동시에 수렴하도록 설계됐다. 또한 내보내기 단계에서 OAuth 토큰·API 키·환경 변수·`.claude.json`을 제외하고 MCP 서버 구성의 자격 증명을 제거하며, 패턴 기반 시크릿 스캔 경고와 공개 저장소 감지 경고를 수행한다. `shared/` 디렉터리에 놓인 스킬·에이전트·규칙만 팀에 공유되고 메모리는 개인 전용으로 남는 분리 모델도 파일 복사 방식에는 없는 제약이다.

어떻게 쓰나

설치는 `/plugin marketplace add toroleapinc/claude-brain` 후 `/plugin install claude-brain-sync`로 마켓플레이스를 추가하고 플러그인을 설치한다. 첫 장비에서는 `/brain-init [email protected]:you/my-brain.git`으로 현재 뇌를 내보내 원격에 푸시하고, 나머지 장비에서는 `/brain-join [email protected]:you/my-brain.git`으로 기존 뇌를 당겨 로컬 상태와 병합한 뒤 자동 동기화를 켠다. 스냅샷을 저장 시점에 암호화하려면 `--encrypt` 플래그를 붙이며, 이후 세션 시작·종료마다 동기화가 자동 수행된다.

전제와 한계

전제 조건은 `git`, `jq`, `claude` CLI이며 암호화를 쓸 때만 `age`가 추가로 필요하다. Claude Code의 로컬 플러그인으로만 동작하므로 영속적인 `~/.claude/`가 없는 클라우드 세션은 지원 대상이 아니며, 읽기 전용 클라우드 변형은 논의 단계에 머물러 있다. 사설 저장소 사용이 강제되고, 신뢰할 수 있는 장비만 추가하는 신뢰 모델을 요구한다. 의미 병합은 호출당 약 $0.01–0.05, 월 $0.50–2.00 수준의 API 비용을 발생시키며 호출당 $0.50 예산 상한이 설정 가능하다. 모든 가져오기 작업은 `~/.claude/brain-backups/`에 백업을 생성한다.

관련 논문 3

유사 도구