Agent Memory

Agents and workspace members share memory in ContextOwl: small Markdown "files" at paths they create, read, search, and prune over time. Memory is scoped to a 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 shared workspace 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 available to workspace members with memory permissions and invisible outside the workspace. A note holds up to 16 KiB, and each plan caps how many notes a workspace keeps (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
• REST API