Create a new memory.

Use this to store important information that should persist across sessions. Memories can be tagged for organization and have trigger phrases that surface them when relevant topics come up.

Example: - Title: "Bash's communication style" - Content: "Direct, concise, no fluff. Lead with conclusions." - Tags: ["preferences", "user-profile"] - Triggers: ["how does bash like responses"]

Get a single memory by its ID.

Returns the full memory including content, tags, triggers, and metadata. Also records that the memory was accessed (updates access count and timestamp).

Update an existing memory.

Only specified fields will be updated. Tags and triggers are replaced entirely if provided (not merged).

Example: - id: "abc-123" - weight: 0.95 # Increase importance - tags: ["high-priority"] # Replace existing tags

Permanently delete a memory.

This cannot be undone. Consider setting status to 'archived' instead if you might need the memory later.

Search memories using full-text search and/or tag filtering.

The query searches both title and content using SQLite FTS5. Results are ranked by relevance and weight.

Examples: - query: "wishly deals" # Find memories about Wishly deals - tags: ["project"] # All memories tagged 'project' - query: "API", tags: ["technical"] # Combine search and filtering

List all memories with optional filtering and sorting.

Use this for browsing memories rather than searching. Returns paginated results with metadata.

Pin or unpin a memory.

Pinned memories:

• Won't decay in weight over time (premium feature)

• Are prioritized in search results

• Useful for critical information like user preferences

Export all active memories to JSON.

Returns a complete export that can be imported later or backed up. Useful for:

• Backing up memories

• Transferring to another system

• Debugging

Import memories from a previous export.

The data must be in the export format with a 'memories' array.

Options:

• overwrite: If true, updates existing memories with matching IDs If false, skips memories that already exist

Returns statistics about the import operation.

Get memory statistics.

Returns:

• Total memory count by status

• Weight distribution

• Most used tags

• Pinned/emotional counts

Useful for understanding your memory landscape.