> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# 自動メモリ

> エージェントがプロジェクトごとにセッションをまたいで自分のメモを保存・想起できるようにする

自動メモリは、エージェントがプロジェクトの外に自分専用の永続的なメモを持てるようにする機能です。これにより、過去の決定・修正・落とし穴を毎回学び直すことなく、後のセッションで思い出せます。

<Info>
  デフォルトで無効です。**設定 > エージェント > 自動メモリを有効化**（[実験的機能](/ja/ctor/reference/settings#実験的機能)の下）でオンにしてください。
</Info>

## 仕組み

有効にすると、各セッションはプロジェクトの外側、`~/.bricks-project-desktop/memory/` 以下にメモリディレクトリを持ちます:

* **プロジェクトチャット**——プロジェクトごとに割り当てられます
* **メインチャット**——すべての[メインチャット](/ja/ctor/guide/main-chat)セッションが単一のディレクトリを共有します
* **ワークツリーチャット**——メモリはブランチやワークツリーのフォルダーではなくプロジェクト単位で割り当てられるため、プロジェクトのメインのチェックアウトと同じメモリディレクトリを共有します。ワークツリーチャットで保存したメモは、メインのチェックアウトのチャットからも見え、その逆も同様です
* **サブエージェント**——セッション中に生成されたサブエージェントは、そのセッションのメモリディレクトリを共有します

`MEMORY.md` はインデックスとして機能します。エージェントはこれを約 200 行以内に保ち、詳細はその横に置いたトピックファイルに移すことになっています。各ターンの開始時に、`MEMORY.md` の最初の 200 行（または 25 KB、どちらか先に達した方まで）が自動的にシステムプロンプトに追加されます。トピックファイルは、その話題が出たときにエージェントが `read_file` で随時読み込みます。

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

エージェントは、何を覚えておく価値があるかを自分で判断します——将来のセッションで役立ちそうな、持続的かつ気づきにくい事実です。たとえば、あなたの修正や好み、決定とその理由、苦労して得たデバッグの知見などです。機密情報、そのセッション限りの一時的な詳細、`AGENTS.md`／`CLAUDE.md` や `application.json` にすでに書かれている内容は保存しないよう指示されています。

いつでもエージェントに何かを覚えておく、あるいは忘れるよう頼めます——他のファイルを編集するのと同じ方法で `MEMORY.md` とそのトピックファイルを更新します。

## ツールアクセス

メモリディレクトリはプロジェクトの外にあるため、`read_file`・`write_file`・`edit_file` はいずれもそこにアクセスでき、メモリへの書き込みはプロジェクトのファイルに通常適用される制限を回避します:

* プロジェクトの[サンドボックス](/ja/ctor/reference/sandbox)の書き込み制限を受けません
* [プランモード](/ja/ctor/reference/plan-mode)によってブロックされません——プランモードが他の操作を読み取り専用に制限している間でも、エージェントはメモリのメモを保存できます
* 診断をトリガーしたり、実行中のアプリに通知したりしません——メモリへの書き込みは、スキルファイルと同様に、[シミュレータ](/ja/ctor/reference/preview)と Config Editor からは見えません

[サンドボックス](/ja/ctor/reference/sandbox)が有効なとき、メモリディレクトリは自動的にサンドボックスの読み取り・書き込み許可リストに追加されるため、追加設定なしでサンドボックス化されたセッションでも動作し続けます。

## メモリフォルダーを開く

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

## データストレージ

| データ   | 場所                                  |
| ----- | ----------------------------------- |
| 自動メモリ | `~/.bricks-project-desktop/memory/` |

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