デフォルトで無効です。設定 > エージェント > 自動メモリを有効化(実験的機能の下)でオンにしてください。
仕組み
有効にすると、各セッションはプロジェクトの外側、~/.bricks-project-desktop/memory/ 以下にメモリディレクトリを持ちます:
- プロジェクトチャット——プロジェクトごとに割り当てられます
- メインチャット——すべてのメインチャットセッションが単一のディレクトリを共有します
- ワークツリーチャット——メモリはブランチやワークツリーのフォルダーではなくプロジェクト単位で割り当てられるため、プロジェクトのメインのチェックアウトと同じメモリディレクトリを共有します。ワークツリーチャットで保存したメモは、メインのチェックアウトのチャットからも見え、その逆も同様です
- サブエージェント——セッション中に生成されたサブエージェントは、そのセッションのメモリディレクトリを共有します
MEMORY.md はインデックスとして機能します。エージェントはこれを約 200 行以内に保ち、詳細はその横に置いたトピックファイルに移すことになっています。各ターンの開始時に、MEMORY.md の最初の 200 行(または 25 KB、どちらか先に達した方まで)が自動的にシステムプロンプトに追加されます。トピックファイルは、その話題が出たときにエージェントが read_file で随時読み込みます。
エージェントが保存する内容
エージェントは、何を覚えておく価値があるかを自分で判断します——将来のセッションで役立ちそうな、持続的かつ気づきにくい事実です。たとえば、あなたの修正や好み、決定とその理由、苦労して得たデバッグの知見などです。機密情報、そのセッション限りの一時的な詳細、AGENTS.md/CLAUDE.md や application.json にすでに書かれている内容は保存しないよう指示されています。
いつでもエージェントに何かを覚えておく、あるいは忘れるよう頼めます——他のファイルを編集するのと同じ方法で MEMORY.md とそのトピックファイルを更新します。
ツールアクセス
メモリディレクトリはプロジェクトの外にあるため、read_file・write_file・edit_file はいずれもそこにアクセスでき、メモリへの書き込みはプロジェクトのファイルに通常適用される制限を回避します:
- プロジェクトのサンドボックスの書き込み制限を受けません
- プランモードによってブロックされません——プランモードが他の操作を読み取り専用に制限している間でも、エージェントはメモリのメモを保存できます
- 診断をトリガーしたり、実行中のアプリに通知したりしません——メモリへの書き込みは、スキルファイルと同様に、シミュレータと Config Editor からは見えません