Skip to main content

Managing Memories

Create, review, flag, and organize your agent's memories.

The Memory dashboard gives you full visibility and control over what your agents remember. You can view all memories, create new ones, flag inaccurate information, and manage how memories are organized.

Viewing Memories​

Navigate to Memory in the CrabShack sidebar to see all stored memories. The dashboard shows:

  • Total count — how many memories are stored
  • Active memories — memories in the Hot and Warm tiers (actively used)
  • Archived memories — memories in the Cold and Archive tiers

Each memory in the list displays its type, content, importance score, tier, scope, source (automatic or manual), and when it was created.

Searching and Filtering​

Use the controls at the top of the memory list to find specific memories:

  • Search — find memories by content (uses meaning-based search, not just keywords)
  • Agent filter — show memories for a specific agent or all agents
  • Type filter — show only a specific type (preference, decision, fact, etc.)
  • Tier filter — show only memories in a specific tier (hot, warm, cold, archive)

When you search, each result includes a relevance score showing how closely it matches your query.

Creating Memories Manually​

While most memories are extracted automatically from conversations, you can also create them manually. This is useful for:

  • Business rules that your agent should always know ("All contracts require legal review before signing")
  • Key context that wouldn't come up naturally in conversation ("Our fiscal year starts in April")
  • Important preferences you want available immediately without waiting for a relevant conversation

To create a memory:

  1. Click Add Memory at the top of the memory list
  2. Enter the content — be clear and specific
  3. Choose the type that best fits (or use Note if unsure)
  4. Set the importance (1-10) — higher importance means the memory is more likely to be placed in a higher tier
  5. Optionally add tags for organization
  6. Click Save
tip

Write memories as clear, standalone statements rather than conversation fragments. "The client's preferred timezone is Pacific" is more useful than "They mentioned they're on the west coast." The clearer the memory, the better the agent can use it.

Flagging Bad Memories​

If you spot a memory that contains inaccurate, outdated, or unhelpful information, you can flag it:

  1. Find the memory in the list
  2. Click the flag button on that row

Flagged memories are excluded from being injected into conversations. This is a quick way to prevent bad information from affecting your agent without deleting the memory entirely. You can unflag a memory later if the issue is resolved.

Editing Memories​

Click on any memory's content in the list to edit it inline. You can update the text, change the type, adjust the importance, modify tags, or move it to a different tier.

Deleting Memories​

To remove a memory permanently, click the delete button on that row. For bulk operations, select multiple memories using the checkboxes and click Delete selected.

note

Deleting a memory is permanent. If you're unsure whether a memory should be removed, consider flagging it instead — this prevents it from being used without losing the information entirely.

Memory Scopes​

Every memory has a scope that determines which agents can access it:

Universal​

Universal memories are shared across all your agents. Use this scope for information that applies broadly:

  • Company-wide policies and procedures
  • General preferences (communication style, report formats)
  • Facts about your organization
  • Industry knowledge that all agents should know

Agent-Specific​

Agent-scoped memories belong to a single agent and are only available to that agent. Use this scope for:

  • Context specific to one agent's role or responsibilities
  • Agent-specific instructions or workflows
  • Information that would be confusing or irrelevant to other agents
tip

If you're not sure which scope to use, start with agent scope. You can always promote a memory to universal later if other agents need it. Going the other direction — realizing a universal memory should have been agent-specific — is harder to undo.

Important: When you delete an agent, all of its agent-scoped memories are deleted too. Universal memories created during that agent's sessions are preserved.

Memory Limits​

The default memory cap is 10,000 memories. When the limit is approached, CrabShack automatically archives the least-used Cold memories to make room. You can adjust this limit in Configuration.

In practice, most CrabShack instances accumulate memories slowly enough that the default limit is more than sufficient. If you're running many agents with frequent conversations, you may want to monitor the total count on the Memory dashboard.