Skip to content
Everruns Cloud is open in early access. Run agents without operating the platform.

Workspace memories in the organization.

CommandWhat it does
memories createCreate a workspace memory in the current organization.
memories deleteArchive a workspace memory.
memories getGet a workspace memory by ID.
memories listList workspace memories in the current organization.
memories syncQueue an immediate sync for a source-backed workspace memory.
memories updateUpdate a workspace memory.

Create a workspace memory in the current organization.

Terminal window
everruns memories create [OPTIONS] --name <name>
FlagDescription
--description <DESCRIPTION>Human-readable description.
--name <NAME>Required. Human-readable name.
--source <SOURCE>

Example:

Terminal window
# Sync a docs repository into a workspace memory
everruns memories create --name design-docs --description 'Living design documents' --source '{"type":"github","repository":"acme/design-docs","branch":"main","root_folder":"docs/"}' --reason 'Give agents the design docs'

Archive a workspace memory.

Terminal window
everruns memories delete [OPTIONS] --memory-id <memory_id>
FlagDescription
--memory-id <MEMORY_ID>Required. Workspace memory’s prefixed public identifier.

Example:

Terminal window
# Archive a memory agents should stop reading
everruns memories delete --memory-id mem_01h9 --reason 'Docs moved to a new repo'

Get a workspace memory by ID.

Terminal window
everruns memories get [OPTIONS] [MEMORY_ID]
FlagDescription
--memory-id <MEMORY_ID>Workspace memory’s prefixed public identifier.

Example:

Terminal window
# Check a memory's source and sync state
everruns memories get mem_01h9

List workspace memories in the current organization.

Terminal window
everruns memories list [OPTIONS]
FlagDescription
--include-archivedInclude archived memories.
--search <SEARCH>Only memories whose name matches this text.

Example:

Terminal window
# Find memories by name when you do not know the id
everruns memories list --search design

Queue an immediate sync for a source-backed workspace memory.

Terminal window
everruns memories sync [OPTIONS] --memory-id <memory_id>
FlagDescription
--memory-id <MEMORY_ID>Required. Workspace memory’s prefixed public identifier.

Example:

Terminal window
# Pull the latest source changes without waiting for the schedule
everruns memories sync --memory-id mem_01h9 --reason 'Docs just changed'

Update a workspace memory.

Terminal window
everruns memories update [OPTIONS] --memory-id <memory_id>
FlagDescription
--description <DESCRIPTION>Human-readable description.
--memory-id <MEMORY_ID>Required. Workspace memory’s prefixed public identifier.
--name <NAME>Human-readable name.
--source <SOURCE>

Example:

Terminal window
# Rename a memory or change its description
everruns memories update --memory-id mem_01h9 --description 'Design docs, main branch' --reason 'Clarify scope'