가이드로 이동

CodeBuddy와 함께 onemind 사용하기(기존 WorkBuddy 호환)

macOS AI 도구 연동 관리자에서 공유 플러그인 패키지를 설치, 업데이트 또는 제거할 수 있습니다. 이 작업은 Project binding을 활성화하거나 업로드를 허용하지 않습니다. Project 지침은 정규 대상 workbuddy를 사용하며, 업로드하려면 사용자가 명시적으로 활성화한 정확한 Project binding의 UploadEnabled가 켜져 있어야 합니다.

CodeBuddy의 현재 실행 파일 이름은 codebuddy, codebuddy-code, cbc이며, onemind는 이 이름으로 CodeBuddy에 연결합니다. 공개 대상 별칭 codebuddy는 호환 키 workbuddy에 매핑됩니다. 네이티브 BETA는 등록된 지침 어댑터용 Project 폴더를 연결할 수 있습니다. 호스트가 연결되면 Mind 동기화를 따르세요. 아래의 CLI 감지 및 명시적 활성화도 사용할 수 있습니다. 감지만으로 쓰기나 업로드를 허용하지 않습니다. CodeBuddy에는 onemind를 통한 관리 스킬이 없습니다. 네이티브 BETA 동기화는 ~/.codebuddy/CODEBUDDY.md에 안정적인 사용자 전체 부트스트랩도 유지합니다. Project 콘텐츠는 바인딩된 폴더에 유지됩니다.

CLI에서 공유 플러그인 패키지를 관리하려면 onemind integrations(install, update, repair, uninstall)를 사용하세요. 이러한 플러그인 작업은 정확한 Project 폴더 바인딩, 지침 동기화, 업로드 활성화와 별개입니다.

먼저 CodeBuddy를 대화형으로 초기화하고 로그인합니다. 수동 상태는 새 미소유 프로필을 실행하지 않습니다. 고정된 ~/.codebuddy 프로필이 없으면 명시적 설치는 CodeBuddy를 실행하거나 영수증을 쓰지 않고 requires_host_initialization을 반환합니다. 프로필 삭제 후에도 영수증이 남아 있으면 업데이트와 제거는 호스트 실행 전에 같은 초기화 오류를 반환하고 영수증을 유지합니다. 기존 프로필은 15초로 제한된 인벤토리 사전 검사를 유지합니다. 검증 설치 후 수동 상태는 CodeBuddy를 다시 실행하지 않고 영수증에 결합된 로컬 스냅샷을 검증합니다.

macOS 앱

  1. OneMind BETA.app에 로그인하고 팀에서 CodeBuddy를 연결하세요.
  2. Mind를 열고 원하는 Project를 선택한 다음 이 Mac의 정확한 폴더를 바인딩하세요.
  3. 승인된 Mind를 열고 동기화를 선택한 다음 도구/기기를 확인하고 지금 동기화를 선택하세요. 전달이 확인될 때까지 기다리세요.
  4. 해당 폴더에서 새 CodeBuddy 세션을 시작하세요. 보류 중, 오프라인, 복구 상태는 Mind 동기화를 참조하세요.

CLI

  1. CodeBuddy에서 작업공간을 엽니다.
  2. onemind project codebuddy .를 실행하여 작업공간을 감지합니다. CLI가 onemind를 열어 감지된 폴더의 Project Mind를 선택하라는 메시지를 출력합니다.
  3. onemind 앱을 열고 동기화 설정에서 감지된 폴더를 원하는 Project Mind에 바인딩합니다.
  4. onemind sync를 실행합니다.
  5. onemind status를 실행합니다.
  6. 선택된 <workspace>/CODEBUDDY.md 또는 <workspace>/AGENTS.md에 onemind 관리 블록이 포함되어 있는지 확인하세요.
  7. 새 CodeBuddy 세션을 시작합니다.

첫 번째 쓰기 시 onemind는 이전 파일을 <workspace>/.one-mind/CODEBUDDY.md.backup(또는 AGENTS.md로 대체할 경우 .one-mind/AGENTS.md.backup)에 저장합니다.

onemind는 CodeBuddy와 기존 WorkBuddy의 앱/설정 위치를 확인하고 ~/CodeBuddy와 ~/WorkBuddy의 후보 기본 경로도 살펴봅니다. 검색은 CodeBuddy/WorkBuddy 레지스트리 데이터베이스를 읽기 전용으로 열고 작업공간/세션 경로 메타데이터만 조회하며 채팅이나 메시지 내용은 읽지 않습니다. macOS가 아닌 시스템에서는 레지스트리 검색을 위해 PATH에서 sqlite3을 사용할 수 있어야 합니다. 검색 결과는 정보일 뿐이며 동기화와 업로드는 사용자가 명시적으로 활성화한 정확한 Project binding으로 제한됩니다.

활성화된 작업공간에서는 일반 파일이며 심볼릭 링크가 아닌 기존 CODEBUDDY.md가 정규 지침 대상입니다. 이 파일이 없으면 onemind는 호환성을 위해 AGENTS.md를 사용합니다. 두 파일이 모두 있으면 현재 관리 블록은 CODEBUDDY.md에만 기록합니다. AGENTS.md에 동일한 정확한 WorkBuddy binding의 이전 관리 블록이 남아 있으면 onemind는 그 블록만 제거하고 나머지 모든 바이트, 파일 모드 및 사용자 작성 내용을 보존합니다. 우선 경로가 심볼릭 링크이거나 일반 파일이 아니면 다른 대상으로 대체하지 않고 동기화를 중지합니다.

활성화된 작업공간에서는 onemind가 검토된 메모리를 동기화하고, 동기화 설정에서 대상에 대해 업로드가 활성화된 경우 일반 Project reconciler가 구조화된 onemind 제안 이벤트를 업로드합니다. 레지스트리 검색은 작업공간/세션 경로 메타데이터만 읽습니다. onemind는 WorkBuddy/CodeBuddy 채팅이나 메시지 내용을 읽거나 호스트의 임의 파일 변경에서 지속 가능한 지식을 생성하지 않습니다.