Memory
The Memory page lets you inspect, search, and manage your agents’ persistent memory and context. Open Memory from the sidebar.
Page Layout
Section titled “Page Layout”The page has three sections:
- Header — Page title with a help tooltip, subtitle (“Agent memory and context management”), and an agent selector dropdown.
- KPI Cards — Four summary cards that update based on the selected agent.
- Tabs — Three tabs for searching memory, viewing workspace files, and checking recent activity.
Agent Selector
Section titled “Agent Selector”A dropdown in the top-right corner lets you select which agent’s memory to inspect. All your agents are listed by name. On page load, the first agent is selected automatically.
If no agents exist or agents fail to load, an error banner appears with a Retry button that reloads the page.
KPI Cards
Section titled “KPI Cards”When an agent is selected, four cards appear in a row:
| Card | Shows |
|---|---|
| Selected agent | The name of the currently selected agent |
| Search results | The number of results from the last search (or -- if no search has been run) |
| Workspace files | How many of the 3 workspace files exist (e.g., 2/3) |
| Recent activities | The number of recent audit log entries loaded |
Memory Search Tab
Section titled “Memory Search Tab”The default tab. It provides:
Search
Section titled “Search”- A search input with placeholder “Search agent memory and logs…”
- A Search button (shows “Searching…” during a query)
- Press Enter to search
Results appear in a scrollable list below the input. Matching text is highlighted in yellow. A footer shows the total result count (e.g., “5 results found”). If no results match, the message “No results found.” is shown. If the search fails, a “Search failed. Please try again.” message appears with a Retry button.
Archive and Clear
Section titled “Archive and Clear”Below the search results, two action buttons are available:
| Button | Action |
|---|---|
| Archive | Exports the agent’s memory to a file. A success banner shows the archive path (e.g., “Memory archived to: /archives/agent-memory-…json”). |
| Clear | Deletes all stored memories for the agent. Opens a confirmation dialog first. |
The Clear confirmation dialog warns: “This will permanently delete all stored memories for [agent name]. This action cannot be undone.” with a destructive Clear Memory button.
Both buttons show a spinner icon while processing and display toast notifications on success or failure.
Workspace Files Tab
Section titled “Workspace Files Tab”Displays the agent’s workspace configuration files. Three file buttons are shown:
| File | Purpose |
|---|---|
| SOUL.md | The agent’s personality and system prompt |
| TOOLS.md | Tool configuration and permissions |
| BOOT.md | Agent bootstrap and initialization instructions |
Each button shows a found badge (green) if the file exists or a n/a badge (gray) if it does not. Files that don’t exist are disabled and cannot be selected.
Click a file button to preview its contents in a scrollable monospace panel below. If a file is not found, the message “[filename] not found in agent workspace” is shown.
A View in Files button in the top-right corner of the tab navigates to the full Files page for managing workspace files.
Recent Activity Tab
Section titled “Recent Activity Tab”Shows the latest 20 audit log entries. Each entry displays:
- Relative timestamp (e.g., “5 min ago”, “2h ago”, “yesterday”) — parsed from the log entry’s ISO timestamp
- Log line in monospace format
The log is refreshed each time you switch to this tab. If no activity has been recorded, the message “No recent activity recorded” is shown. While loading, a “Loading activity…” message appears.
Empty State
Section titled “Empty State”If no agent is selected, a centered card explains what agent memory is:
Memory allows your agents to retain context across conversations. They learn from interactions and build long-term knowledge. Select an agent above to explore, search, or manage their memories.