SearchMemories

Search memory files by content with three modes: Hybrid (default), Semantic, and FullText.

Parameters

• query (string, required): Search terms - looks in FILE contents
• mode (string, optional): "Hybrid" (default), "Semantic", or "FullText"
• pageSize (int, optional): Max FILES to return (default: 10)
• page (int, optional): Page number for results (default: 1)
• folder (string, optional): Filter by folder path
• tags (string[], optional): Filter by tags (must match all)
• minScore (number, optional): Minimum score threshold (default: 0.0)

Returns

Examples

Scoring

• Hybrid: Reciprocal Rank Fusion (RRF) over text + semantic ranks; minScore applies to the fused score.
• Semantic: Vector similarity normalized to 0–1; minScore applies to the semantic score.
• FullText: Term-frequency score normalized to 0–1 (relative to best hit); minScore applies to the normalized score.

Notes:

• Queries must contain at least one non-stopword keyword (empty/stopword-only queries return an error).
• The tool does not currently enforce page >= 1 / pageSize >= 1; use those values anyway (e.g., pageSize: 0 returns no results).

Patterns

• Pre-creation check: Search before WriteMemory to avoid duplication
• Context building: Find background for Sequential Thinking sessions
• Solution discovery: Search error messages or "fix", "solution"
• Concept exploration: Search [[WikiLink]] names like [[machine-learning]], [[research]] for graph nodes
• Project-specific: Use folder filtering for targeted discovery

Decay Weighting

Search results are weighted by recency using time-based decay:

How it works:

• Scores are multiplied by a decay weight (0.0-1.0) based on file age
• Recent content ranks higher; stale content naturally sinks
• Decay is based on last_accessed if available, otherwise created date

Grace periods (full weight = 1.0):

• thinking/sequential/: 7 days
• thinking/workflows/: 14 days
• All other memory: 28 days

After grace period:

• Exponential decay with 30-day half-life (default)
• At 30 days past grace: weight = 0.5
• At 60 days past grace: weight = 0.25

Environment variables:

• MAENIFOLD_DECAY_GRACE_DAYS_SEQUENTIAL (default: 7)
• MAENIFOLD_DECAY_GRACE_DAYS_WORKFLOWS (default: 14)
• MAENIFOLD_DECAY_GRACE_DAYS_DEFAULT (default: 28)
• MAENIFOLD_DECAY_HALF_LIFE_DAYS (default: 30)
• MAENIFOLD_DECAY_FUNCTION ("exponential" | "power-law")

Note: SearchMemories does NOT update last_accessed. Use ReadMemory to boost a file's recency.

Integration

• ReadMemory: Access full content using memory:// URIs from results
• BuildContext: Traverse concept relationships from search results
• Sync: Rebuild graph when results seem incomplete
• WriteMemory: Create new knowledge after checking for existing content