# everruns memories

> Workspace memories in the organization. CLI reference for everruns memories.

Source: <https://everruns.com/docs/reference/cli/memories/>

Workspace memories in the organization.

| Command                               | What it does                                                  |
| ------------------------------------- | ------------------------------------------------------------- |
| [`memories create`](#memories-create) | Create a workspace memory in the current organization.        |
| [`memories delete`](#memories-delete) | Archive a workspace memory.                                   |
| [`memories get`](#memories-get)       | Get a workspace memory by ID.                                 |
| [`memories list`](#memories-list)     | List workspace memories in the current organization.          |
| [`memories sync`](#memories-sync)     | Queue an immediate sync for a source-backed workspace memory. |
| [`memories update`](#memories-update) | Update a workspace memory.                                    |

## memories create

Create a workspace memory in the current organization.

```bash
everruns memories create [OPTIONS] --name <name>
```

| Flag                          | Description                    |
| ----------------------------- | ------------------------------ |
| `--description <DESCRIPTION>` | Human-readable description.    |
| `--name <NAME>`               | Required. Human-readable name. |
| `--source <SOURCE>`           |                                |

Example:

```bash
# 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'
```

## memories delete

Archive a workspace memory.

```bash
everruns memories delete [OPTIONS] --memory-id <memory_id>
```

| Flag                      | Description                                              |
| ------------------------- | -------------------------------------------------------- |
| `--memory-id <MEMORY_ID>` | Required. Workspace memory’s prefixed public identifier. |

Example:

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

## memories get

Get a workspace memory by ID.

```bash
everruns memories get [OPTIONS] [MEMORY_ID]
```

| Flag                      | Description                                    |
| ------------------------- | ---------------------------------------------- |
| `--memory-id <MEMORY_ID>` | Workspace memory’s prefixed public identifier. |

Example:

```bash
# Check a memory's source and sync state
everruns memories get mem_01h9
```

## memories list

List workspace memories in the current organization.

```bash
everruns memories list [OPTIONS]
```

| Flag                 | Description                                 |
| -------------------- | ------------------------------------------- |
| `--include-archived` | Include archived memories.                  |
| `--search <SEARCH>`  | Only memories whose name matches this text. |

Example:

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

## memories sync

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

```bash
everruns memories sync [OPTIONS] --memory-id <memory_id>
```

| Flag                      | Description                                              |
| ------------------------- | -------------------------------------------------------- |
| `--memory-id <MEMORY_ID>` | Required. Workspace memory’s prefixed public identifier. |

Example:

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

## memories update

Update a workspace memory.

```bash
everruns memories update [OPTIONS] --memory-id <memory_id>
```

| Flag                          | Description                                              |
| ----------------------------- | -------------------------------------------------------- |
| `--description <DESCRIPTION>` | Human-readable description.                              |
| `--memory-id <MEMORY_ID>`     | Required. Workspace memory’s prefixed public identifier. |
| `--name <NAME>`               | Human-readable name.                                     |
| `--source <SOURCE>`           |                                                          |

Example:

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