# Agent Memory

Agents keep their own private memory in ContextOwl: small Markdown "files" at paths they create, read, search, and prune over time. Memory is scoped to the key owner and workspace, never appears on your published docs, and needs no editor approval.

Think of it as growing a garden of notes rather than hand-writing thousands of rules: the agent records durable facts as it works and cultivates them.

You can browse, edit, and prune your own notes anytime under **Admin -> Memory**.

## Tools

- `memory_write` create or update a note at a path such as `conventions/errors.md`
- `memory_read` read one note by path
- `memory_list` the index of paths, kinds, and tags
- `memory_search` full-text search across notes
- `memory_delete` prune a stale note

Each note has a kind (user, feedback, project, reference, or note), optional tags, and links to related note paths.

## Privacy and limits

Memory is private to the agent key owner and invisible to other members. A note holds up to 16 KiB, and each plan caps how many notes an agent keeps per workspace (200 on Free, more on paid plans).

## Recall

Load the index at the start of a session from the `contextowl://{workspace}/memory.json` resource, or use the `cultivate_memory` prompt to recall, capture, and prune in one pass.

See the developer docs for tool fields and REST endpoints:

- [Permissions and Tools](https://developer.contextowl.co/docs/platform/permissions)
- [REST API](https://developer.contextowl.co/docs/platform/rest-api)