# remember

Conserva información duradera que un agente autorizado pueda recuperar más adelante. Es la API directa de escritura duradera; los flujos de eventos deben pasar por la política de captura antes de llamarla.

- Canonical: https://docs.xmemo.dev/es/docs/tools/remember
- Locale: es-ES
- Content-Locale: es-ES
- Canonical-Content-Digest: b5d03421cd10a63875746f6339e99b93d92fcef8443db7176726d5aea32edd65
- Edition-Digest: b87eec856a09bd88c21e33ee1687117c30ca9cf4a7d33ebaa0f79128977b16db
- Source-Revision: sha256:9a04d6faf83e5b7c52876a378ff80d66a4b9561a8bd8f786716b130083cffebb

## Tool Reference: `remember`

### Purpose

Conserva información duradera que un agente autorizado pueda recuperar más adelante. Es la API directa de escritura duradera; los flujos de eventos deben pasar por la política de captura antes de llamarla.

### Parameters

- `content` (string, required): Cuerpo de la memoria duradera. Mantenlo factual, acotado y sin secretos.
- `path` (string, required): Ubicación lógica que vincula la memoria a un proyecto o namespace duradero.
- `create_project` (boolean, optional, default: false): Solo para el perfil público genérico: crea el proyecto propietario si el path implica uno. No se acepta en los perfiles de plugin de ChatGPT o Claude.

### Returns

El texto de éxito incluye la referencia/ID de la memoria guardada, el path lógico, la identidad del escritor, la cuenta y la etiqueta del dispositivo. Los clientes públicos deben tratar la referencia como un identificador opaco.

### Errors

- 401/403: falta el token MCP o no incluye memory:write.
- Error de validación: content o path está vacío, se proporcionó JSON mal formado o un valor incumple el contrato de almacenamiento.
- Error de autorización: el llamador no puede escribir en el scope, proyecto o equipo solicitado.
- Rechazo de seguridad: se bloqueó o saneó contenido parecido a un secreto o metadatos de identidad reservados.

### Examples

#### Guarda una decisión duradera explícita



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

### Related Tools

- [recall](/docs/tools/recall): Obtén algunas memorias relevantes después de guardar un hecho duradero.
- [recall_context](/docs/tools/recall-context): Construye un paquete de contexto acotado antes de una tarea posterior.
- [ledger](/docs/tools/ledger): Guarda registros financieros sujetos a control en lugar de memoria genérica.

## Confirma que la escritura se ha guardado

Lee de nuevo la memoria mediante una búsqueda con alcance definido en lugar de confiar únicamente en la respuesta de escritura.

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