# useDocyrusAgentMemories
URL: /docs/native/hooks/use-docyrus-agent-memories

Backend glue for the DocyrusAgent memory manager — list, create, update and delete /v1/ai/memories with optimistic local state.

## Installation

```bash
pnpm dlx @docyrus/cli add @docyrus/rn-hooks-use-docyrus-agent-memories
```

A verbatim port of the web hook (no React Query — plain local state with optimistic updates). Feed its result into [`DocyrusAgentMemoriesView`](/docs/native/docyrus/docyrus-agent#memories).

## Usage

```tsx
import { DocyrusAgentMemoriesView } from '@/components/docyrus-native/docyrus-agent';
import { useDocyrusAgentMemories } from '@/hooks/docyrus-native/use-docyrus-agent-memories';

const memories = useDocyrusAgentMemories({ client, agentId: AGENT_ID, userId: user?.id });

```

## API Reference

### UseDocyrusAgentMemoriesArgs

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `client` | `DocyrusAgentMemoriesClient \| null \| undefined` | - | Client with `get` / `post` / `patch` / `delete` |
| `enabled` | `boolean` | `true` | Run the initial fetch |
| `agentId` | `string` | - | Agent scope of created memories |
| `projectId` | `string \| null` | `null` | Project scope of created memories |
| `userId` | `string \| null` | `null` | User scope of created memories |
| `listParams` | `Record<string, string \| number \| boolean \| null \| undefined>` | - | Extra query params for the list call |

### UseDocyrusAgentMemoriesResult

| Field | Type | Description |
|-------|------|-------------|
| `memories` | `ReadonlyArray<DocyrusAgentMemory>` | Current list |
| `isLoading` / `isSaving` | `boolean` | Fetch / save state |
| `deletingId` | `string \| null` | Memory being deleted |
| `error` | `string \| null` | Last error message |
| `refresh` | `() => Promise<void>` | Re-fetch `GET /v1/ai/memories` |
| `create` | `(form: DocyrusAgentMemoryFormState) => Promise<DocyrusAgentMemory \| null>` | `POST /v1/ai/memories` |
| `update` | `(memory, form) => Promise<DocyrusAgentMemory \| null>` | `PATCH /v1/ai/memories/{id}` |
| `remove` | `(memory) => Promise<boolean>` | `DELETE /v1/ai/memories/{id}` |