CLI: Memories

Memories are key/value facts the agent can recall across sessions. The runtime may also write unkeyed memories; those appear in list output for audit, but set and unset operate by key.

List memories

valet memories [--agent <agent>] [--org <org>]

$ valet memories --agent my-agent
=== Memories: my-agent agent

=== schema/users
  Key:     schema/users
  Content: users(id, email)
  Pinned:  yes
  Created: 2026-06-01T12:00:00Z
  Expires: never

Set a memory

valet memories set <KEY=VALUE> [--pin] [--ttl <seconds>] [--agent <agent>]

Creates or updates one keyed memory. If the key already exists, content is replaced in place. Passing --pin marks the memory for pinned-context injection — it is placed in the agent's context every turn. Pass --ttl to expire the memory after that many seconds; omitting it creates the memory without an expiry.

$ valet memories set schema/users='users(id, email)' --pin --agent my-agent
Setting schema/users on my-agent agent... done
Set schema/users

Unset a memory

valet memories unset <KEY> [--agent <agent>]

Removes one keyed memory without restarting the agent. Runtime turns after removal no longer recall or pin that key.