Skip to main content
自動メモリは、エージェントがプロジェクトの外に自分専用の永続的なメモを持てるようにする機能です。これにより、過去の決定・修正・落とし穴を毎回学び直すことなく、後のセッションで思い出せます。
デフォルトで無効です。設定 > エージェント > 自動メモリを有効化実験的機能の下)でオンにしてください。

仕組み

有効にすると、各セッションはプロジェクトの外側、~/.bricks-project-desktop/memory/ 以下にメモリディレクトリを持ちます:
  • プロジェクトチャット——プロジェクトごとに割り当てられます
  • メインチャット——すべてのメインチャットセッションが単一のディレクトリを共有します
  • ワークツリーチャット——メモリはブランチやワークツリーのフォルダーではなくプロジェクト単位で割り当てられるため、プロジェクトのメインのチェックアウトと同じメモリディレクトリを共有します。ワークツリーチャットで保存したメモは、メインのチェックアウトのチャットからも見え、その逆も同様です
  • サブエージェント——セッション中に生成されたサブエージェントは、そのセッションのメモリディレクトリを共有します
MEMORY.md はインデックスとして機能します。エージェントはこれを約 200 行以内に保ち、詳細はその横に置いたトピックファイルに移すことになっています。各ターンの開始時に、MEMORY.md の最初の 200 行(または 25 KB、どちらか先に達した方まで)が自動的にシステムプロンプトに追加されます。トピックファイルは、その話題が出たときにエージェントが read_file で随時読み込みます。

エージェントが保存する内容

エージェントは、何を覚えておく価値があるかを自分で判断します——将来のセッションで役立ちそうな、持続的かつ気づきにくい事実です。たとえば、あなたの修正や好み、決定とその理由、苦労して得たデバッグの知見などです。機密情報、そのセッション限りの一時的な詳細、AGENTS.mdCLAUDE.mdapplication.json にすでに書かれている内容は保存しないよう指示されています。 いつでもエージェントに何かを覚えておく、あるいは忘れるよう頼めます——他のファイルを編集するのと同じ方法で MEMORY.md とそのトピックファイルを更新します。

ツールアクセス

メモリディレクトリはプロジェクトの外にあるため、read_filewrite_fileedit_file はいずれもそこにアクセスでき、メモリへの書き込みはプロジェクトのファイルに通常適用される制限を回避します:
  • プロジェクトのサンドボックスの書き込み制限を受けません
  • プランモードによってブロックされません——プランモードが他の操作を読み取り専用に制限している間でも、エージェントはメモリのメモを保存できます
  • 診断をトリガーしたり、実行中のアプリに通知したりしません——メモリへの書き込みは、スキルファイルと同様に、シミュレータと Config Editor からは見えません
サンドボックスが有効なとき、メモリディレクトリは自動的にサンドボックスの読み取り・書き込み許可リストに追加されるため、追加設定なしでサンドボックス化されたセッションでも動作し続けます。

メモリフォルダーを開く

チャットが少なくとも 1 つのメモリファイルを保存すると、アクションメニューに メモリを開く が表示され、クリックするとメモリディレクトリがファイルマネージャーで開きます。ディレクトリに内容があるまで、この項目は表示されません。

データストレージ

BRICKS_PROJECT_DESKTOP_DATA_DIR 環境変数を設定すると、デフォルトのデータディレクトリ(~/.bricks-project-desktop/)を上書きでき、メモリのルートも一緒に移動します。