# remember

capture policy、scope、secret-redactionの境界を満たした後にだけ、永続memoryを書き込みます。

- Canonical: https://docs.xmemo.dev/ja/docs/tools/remember
- Locale: ja-JP
- Content-Locale: ja-JP
- Canonical-Content-Digest: b5d03421cd10a63875746f6339e99b93d92fcef8443db7176726d5aea32edd65
- Edition-Digest: 1764e79b4207b30037f89cfbedd5740bd49a2b7ff8a41dace8ce543e29e8f146
- Source-Revision: sha256:9a04d6faf83e5b7c52876a378ff80d66a4b9561a8bd8f786716b130083cffebb

## Tool Reference: `remember`

### Purpose

承認済みのagentが後でrecallできるよう、永続的な情報を保存します。これは直接的なdurable-write APIです。event streamは呼び出す前にcapture policyを通す必要があります。

### Parameters

- `content` (string, required): 永続メモリの本文です。事実に基づき、範囲を限定し、secretを含めないでください。
- `path` (string, required): メモリをprojectまたは永続namespaceに結び付ける論理的位置です。
- `create_project` (boolean, optional, default: false): Generic public profileでのみ使用します。pathがprojectを示す場合に所有projectを作成します。ChatGPTまたはClaude plugin profileでは受け付けません。

### Returns

成功テキストには、保存されたメモリのreference/ID、論理path、writer identity、account、device labelが含まれます。Public clientはreferenceをopaque identifierとして扱ってください。

### Errors

- 401/403: MCP tokenがない、またはmemory:writeを含んでいません。
- Validation failure: contentまたはpathが空、malformed JSONが指定された、または値がstorage contractに違反しています。
- Authorization failure: callerは要求されたscope、project、teamに書き込めません。
- Safety rejection: secretのようなcontent、または予約済みidentity metadataがブロックまたはsanitizationされました。

### Examples

#### 明示的な永続decisionを保存する



```typescript
remember({
  content: "Use OAuth for hosted ChatGPT connections.",
  path: "projects/memory-os/decisions"
})
```

### Related Tools

- [recall](/docs/tools/recall): 永続factを保存した後、関連するメモリを少数取得します。
- [recall_context](/docs/tools/recall-context): 後続のtaskの前に、範囲を限定したcontext packを作成します。
- [ledger](/docs/tools/ledger): generic memoryではなく、管理対象のfinancial recordを保存します。

## 書き込みが反映されたことを確認する

書き込みresponseだけを信頼せず、scopeを指定したsearchでmemoryを読み戻します。

```ts
search_memory({
  query: "OAuth for hosted ChatGPT connections",
  limit: 3
})
```