# remember

capture policy, scope 및 secret-redaction 경계를 충족한 후에만 영구 memory를 저장합니다.

- Canonical: https://docs.xmemo.dev/ko/docs/tools/remember
- Locale: ko-KR
- Content-Locale: ko-KR
- Canonical-Content-Digest: b5d03421cd10a63875746f6339e99b93d92fcef8443db7176726d5aea32edd65
- Edition-Digest: 264a1918b0ef09779272ba94eb5f4c82d45d64c321a1cb5004b11ea7a0d5578b
- Source-Revision: sha256:9a04d6faf83e5b7c52876a378ff80d66a4b9561a8bd8f786716b130083cffebb

## Tool Reference: `remember`

### Purpose

승인된 agent가 나중에 recall할 수 있도록 영구 정보를 저장합니다. 직접 durable-write API이며 event stream은 호출 전에 capture policy를 거쳐야 합니다.

### Parameters

- `content` (string, required): 영구 memory 본문입니다. 사실에 기반하고 범위를 제한하며 secret이 없도록 유지합니다.
- `path` (string, required): memory를 project 또는 영구 namespace에 연결하는 데 사용하는 논리적 위치입니다.
- `create_project` (boolean, optional, default: false): Generic public profile 전용입니다. path가 project를 암시하면 owner project를 생성합니다. ChatGPT 또는 Claude plugin profile에서는 허용되지 않습니다.

### Returns

성공 text에는 저장된 memory 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: 호출자가 요청한 scope, project 또는 team에 쓸 수 없습니다.
- Safety rejection: secret처럼 보이는 content 또는 예약된 identity metadata가 차단되거나 sanitized됩니다.

### Examples

#### 명시적인 영구 decision 저장



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

### Related Tools

- [recall](/docs/tools/recall): 영구 fact를 저장한 뒤 관련 memory 몇 개를 가져옵니다.
- [recall_context](/docs/tools/recall-context): 이후 task 전에 범위가 제한된 context pack을 만듭니다.
- [ledger](/docs/tools/ledger): generic memory 대신 관리되는 financial record를 저장합니다.

## 쓰기 완료 확인

쓰기 응답만 믿지 말고 scope가 지정된 search를 통해 memory를 다시 읽습니다.

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