toroleapinc/claude-brain

Claude Code의 brain을 여러 기기 간에 동기화하세요 — 휴대 가능하고, 자동이며, 지능적입니다.

claude-brain은 brain sync를 위한 Claude Code 플러그인입니다. Claude Code의 메모리(memory), 기술(skills), 에이전트(agents), 규칙(rules) 및 설정(settings)을 의미론적 병합(semantic merge)을 통해 모든 기기 간에 동기화합니다. 기기 간 이동이 가능하며, 휴대 가능하고, 매일 별도의 노력이 필요하지 않습니다.

# Machine A (업무용 노트북) — 최초 설정
> /brain-init git@github.com:you/my-brain.git
✓ Brain exported: 42 memory entries, 3 skills, 5 rules
...

두 개의 명령. 매일 드는 노력 제로. 영구적으로 작동합니다.

당신은 여러 기기에서 Claude Code를 사용합니다. 노트북은 당신의 코딩 패턴을 학습했습니다. 데스크톱에는 커스텀 기술(skills)이 있습니다. 클라우드 VM에는 서로 다른 규칙(rules)이 있습니다. 이들은 서로 소통하지 못합니다.

기기를 바꿀 때마다 문맥(context)을 잃게 됩니다. Claude에게 똑같은 것들을 다시 가르쳐야 합니다. 정성스럽게 작성한 CLAUDE.md는 그 자리에 남겨집니다.

# Machine A (업무용 노트북)
> /brain-init git@github.com:you/my-brain.git
✓ Brain exported: 42 memory entries, 3 skills, 5 rules
...

두 개의 명령. 매일 드는 노력 제로. 영구적으로 작동합니다.

도구	기능	claude-brain이 추가하는 기능
claude-mem	한 대의 기기에서 메모리(memory) 강화	모든 기기에 걸쳐 전체 brain 동기화
chezmoi / dotfiles	설정 파일(config files) 복사	지능적으로 지식 병합 — 모순 해결 및 중복 제거
수동 CLAUDE.md 복사	작동은 하지만 번거로움	매 세션 시작/종료 시 조용히 자동 동기화

다른 어떤 도구도 Claude Code의 brain 상태에 대해 기기 간 의미론적 병합(cross-machine semantic merge)을 수행하지 않습니다.

자동 동기화 (Auto-sync)— 매 세션 시작/종료 시 훅(hooks)이 실행되어 노력이 전혀 들지 않음
의미론적 병합 (Semantic merge)— LLM 기반의 메모리 및 CLAUDE.md 중복 제거 (단순 덮어쓰기가 아님)
N-way 병합 (N-way merge)— 노트북 + 데스크톱 + 클라우드 VM이 모두 지능적으로 수렴
암호화 (Encryption)— 선택 사항인 age 사용

저장 시 (at rest) brain 스냅샷에 대한 암호화 (Encryption)
팀 공유 (Team sharing)— 기술 (skills), 에이전트 (agents), 규칙 (rules)을 팀원과 공유
자동 진화 (Auto-evolve)— 메모리로부터 안정적인 패턴을 내구성 있는 설정 (config)으로 승격
보안 우선 (Security-first)— 비밀 정보 (secrets) 제거, 환경 변수 (env vars) 제외, 프라이빗 리포지토리 (private repo) 강제
매우 저렴한 비용 (Dirt cheap)— claude -p를 통한 일반적인 사용 시 월 약 $0.50-2.00

# 마켓플레이스 추가 및 설치
/plugin marketplace add toroleapinc/claude-brain
/plugin install claude-brain-sync

/brain-init git@github.com:you/my-brain.git

/brain-join git@github.com:you/my-brain.git

/brain-init git@github.com:you/my-brain.git --encrypt

완료되었습니다. 이제부터 자동 동기화 (Auto-sync)가 모든 것을 처리합니다.

명령 (Command)	설명 (Description)
/brain-init <remote>	Git 원격 저장소 (remote)로 brain 네트워크 초기화
/brain-join <remote>	기존 brain 네트워크에 참여
/brain-status	brain 인벤토리 및 동기화 상태 표시
/brain-sync	전체 동기화 사이클 수동 실행
/brain-evolve	메모리에서 안정적인 패턴을 설정 (config)으로 승격
/brain-conflicts	병합 충돌 (merge conflicts) 검토 및 해결
/brain-share <type> <name>	기술 (skill), 에이전트 (agent), 또는 규칙 (rule)을 팀과 공유
/brain-shared-list	네트워크 내의 모든 공유된 아티팩트 (artifacts) 목록 표시
/brain-log	동기화 이력 표시

구성 요소 (Component)	동기화 여부 (Synced?)	병합 전략 (Merge Strategy)
CLAUDE.md	예 (Yes)	의미론적 병합 (Semantic merge)
OAuth tokens	아니요 (Never)	보안 (Security)
Env vars	아니요 (Never)	기기 특정적 (Machine-specific)
API keys	아니요 (Never)	자동으로 제거됨 (Stripped automatically)

Machine A Machine B Machine C
┌──────────┐ ┌──────────┐ ┌──────────┐
│ claude- │ │ claude- │ │ claude- │
...

중앙 서버는 없습니다. Git이 전송 (transport)을 담당합니다. 각 기기는 pull 시 병합 (merge)합니다.

병합 전략 (Merge strategy):

구조화된 데이터 (Structured data) (설정 (settings), 키 바인딩 (keybindings), MCP) → 결정론적 JSON 딥 머지 (deterministic JSON deep-merge) (무료)
비구조화된 데이터 (Unstructured data) (메모리 (memory), CLAUDE.md) → claude -p를 통한 LLM 기반 의미론적 병합 (LLM-powered semantic merge) (약 $0.01-0.05)

claude-brain은 보안을 최우선 사항으로 설계되었습니다:

비밀 정보 (Secrets)는 절대 내보내지 않음— OAuth 토큰, API 키, 환경 변수 (env vars), .claude.json

모두 제외됨패턴 기반 비밀 정보 스캐닝 (Pattern-based secret scanning)— 메모리에서 잠재적인 비밀 정보가 감지되면 경고를 보냄MCP 환경 변수 (env vars) 제거— 서버 설정이 자격 증명 없이 동기화됨프라이빗 저장소 (Private repo) 강제— 퍼블릭 저장소가 감지되면 경고를 보냄자동 백업 (Automatic backups)— 모든 임포트 (import) 시 ~/.claude/brain-backups/에 백업 생성

머신 신뢰 모델 (Machine trust model)— 본인이 완전히 제어할 수 있는 머신만 추가할 것선택적 암호화 (Optional encryption)— 저장된 스냅샷 (snapshots at rest)을 위한 age 암호화

아래의 전체 보안 공지 (Security Notice)를 참조하십시오.

작업 (Operation)	비용 (Cost)	시점 (When)
구조적 병합 (Structured merge)	무료 (Free)	모든 동기화 (Every sync)
의미적 병합 (Semantic merge)	~$0.01–0.05	콘텐츠가 다를 때만
자동 진화 (Auto-evolve)	~$0.02–0.10	최대 7일에 한 번
내보내기 / 가져오기 (Export / import)	무료 (Free)	모든 동기화 (Every sync)

일반적인 월간 비용: 활발한 다중 머신 사용 시 $0.50–2.00 예산 상한선: 호출당 $0.50 (설정 가능).

플랫폼 (Platform)	상태 (Status)
Linux	완벽 지원 (Fully supported)
...

claude-brain은 SessionStart 및 SessionEnd를 후킹 (hook)하여 git을 셸 명령으로 실행하고 ~/.claude/를 읽고 쓰는 로컬 플러그인 (local plugin)으로 동작합니다. 클라우드 세션 (Cloud sessions)은 휘발성이고 샌드박스 (sandboxed) 환경이며, 동기화할 지속적인 ~/.claude/가 없으므로 현재 아키텍처가 적용되지 않습니다. 향후 읽기 전용 클라우드 변형 (read-only Cloud variant)이 어떤 모습일지에 대한 논의는 #32를 참조하십시오.

git — 동기화 전송 (sync transport)
jq — JSON 처리 (apt install jq / brew install jq)
claude CLI — 의미적 병합 (Claude Code와 함께 이미 설치됨)
age — 암호화를 위한 선택 사항

팀원들과 기술 (skills), 에이전트 (agents), 규칙 (rules)을 공유하십시오:

/brain-share skill my-useful-tool.md
/brain-share agent debugger.md
/brain-share rule security.md

공유된 아티팩트 (Shared artifacts)는 brain 저장소의 shared/에 저장됩니다. 메모리 (Memory)는 절대로 공유되지 않으며 개인용으로만 유지됩니다. 팀원들은 다음 동기화 시 공유된 아티팩트를 받게 됩니다.

brain은 7일마다 (설정 가능) 진화 분석 (evolution analysis)을 실행합니다. 이 과정은 다음과 같습니다:

• 안정적이고 반복되는 패턴을 위해 메모리를 분석합니다.
• 높은 신뢰도(>0.9)의 승격(promotions)은 자동으로 적용됩니다.
• 신뢰도가 낮은 제안은 /brain-conflicts를 통해 수동 검토를 위해 대기열에 추가됩니다.

/brain-evolve 명령어로 언제든지 수동으로 실행할 수 있습니다.

/brain-init git@github.com:you/my-brain.git --encrypt

• 기기당 하나의 age 키 쌍(keypair)을 생성합니다 - 푸시(push) 전 암호화된 스냅샷을 생성하고, 풀(pull) 시 복호화합니다.
• meta/recipients.txt 파일이 액세스 권한을 제어합니다.
• 암호화되지 않은 스냅샷과 하위 호환성을 유지합니다.

claude-brain을 사용하기 전에 이 내용을 읽으십시오. 이 플러그인은 Git 원격 저장소를 통해 사용자의 Claude Code 설정을 동기화합니다. 어떤 데이터가 기기를 벗어나는지 이해하십시오:

• CLAUDE.md, 규칙(rules), 기술(skills), 에이전트(agents)

• 자동 메모리 및 에이전트 메모리

• 설정 (훅(hooks), 권한(permissions) — 환경 변수(env vars)는 제외)

• MCP 서버 설정 (환경 변수는 제거됨)

• 키 바인딩(Keybindings)

• 기기 호스트 이름(hostname) 및 프로젝트 디렉토리 이름

• OAuth 토큰 및 API 키 ~/.claude.json (자격 증명(credentials))

• 설정의 환경 변수(Environment variables)

• MCP 서버 env 필드

• .local 설정 파일

• 세션 트랜스크립트(Session transcripts)

PRIVATE Git 저장소를 사용하십시오. 공개 저장소가 감지되면 플러그인이 경고합니다.
메모리에 민감한 컨텍스트가 포함될 수 있습니다. 초기화하기 전에 검토하십시오.
Git 히스토리는 영구적입니다. 필요한 경우 git-filter-repo를 사용하여 삭제하십시오.
자동 동기화는 조용히 실행됩니다. 각 임포트(import) 전에 백업이 생성됩니다.
시맨틱 머지(Semantic merge)는 Claude API를 사용합니다. 메모리 내용은 claude -p로 전송됩니다.
네트워크 내의 모든 기기를 신뢰하십시오. 임포트된 기술은 Claude의 권한으로 실행됩니다.

기여를 환영합니다! 가이드라인은 CONTRIBUTING.md를 참조하세요.

MIT