ガイドへ移動

CodeBuddy で onemind を使用する（旧 WorkBuddy 互換）

macOS の AI ツール連携マネージャーでは、共有プラグインパッケージをインストール、更新、アンインストールできます。これらの操作は Project binding の有効化やアップロードの許可を行いません。Project 指示は正規ターゲット workbuddy を使用し、アップロードにはユーザーが明示的に有効化した正確な Project binding の UploadEnabled が必要です。

CodeBuddy の現在の実行ファイル名は codebuddy、codebuddy-code、cbc です。公開ターゲット別名 codebuddy は互換キー workbuddy に対応します。ネイティブ BETA は登録済み指示アダプター用に Project フォルダを関連付けられます。ホスト接続後は Mind 同期に従ってください。CLI 検出と明示的な有効化は下記で利用できます。検出だけで書き込みやアップロードは許可されません。CodeBuddy には onemind による管理スキルはありません。ネイティブ BETA 同期では ~/.codebuddy/CODEBUDDY.md にユーザー全体の安定したブートストラップも維持されます。Project のコンテンツはバインドされたフォルダに保存されます。

onemind integrations（install、update、repair、uninstall）を使用して、CLI から共有プラグインパッケージを管理します。これらのプラグイン操作は、正確な 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 のチャットやメッセージの内容を読み取ったり、ホスト側の任意のファイル変更から永続的なナレッジを生成したりすることはありません。