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

# Use Workspace Memory

> Record durable preferences and procedures an agent recalls on later turns.

This walkthrough uses [memory](/concepts/memory) so an agent remembers a preference across sessions instead of re-asking. Memory is part of the in-workspace agent command surface (`workspace_cli`).

## 1. Read current memory

```bash theme={null}
workspace_cli memory read --scope agent
```

This returns the agent's persona plus its structured entries. Use `--scope shared` for the workspace knowledge index.

## 2. Add a durable entry

Pick the type that matches the knowledge — `preference`, `feedback`, `procedure`, `reference`, or `context`:

```bash theme={null}
workspace_cli memory entry add \
  --type preference \
  --title "Status cadence" \
  --description "How often to post status updates" \
  --body "Post a concise status every Monday at 09:00 in the team channel."
```

The command returns a unique slug once the entry is stored.

## 3. Recall it later

```bash theme={null}
workspace_cli memory entry read status-cadence
```

Because memory is read fresh each turn, the agent applies the preference on every subsequent activation without being told again. Choosing an accurate `--type` keeps recall relevant — a `procedure` and a `preference` are surfaced for different intents.