memory-search

Search and retrieve episodic memory entries from Gaia's Memory v2 index.

3|1|Updated Nov 10, 2025
One-click install
npx skills add https://github.com/metraton/gaia --skill memory-search-metraton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-search
Source: https://github.com/metraton/gaia/tree/main/skills/memory-search
Command: npx skills add https://github.com/metraton/gaia --skill memory-search-metraton

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inspect and query Gaia's episodic memory (Memory v2) through the gaia memory CLI. Memory v2 indexes past sessions in an FTS5 SQLite database with hybrid scoring (recency + retrieval count). This skill covers search, stats, show, and conflict detection. For curating/reorganizing the separate MEMORY.md index and topic files, load memory-curation instead.

Core Features & Use Cases

  • Search for memories by topic or keyword and retrieve top matches with scores.
  • Retrieve detailed memory entries with gaia memory show and examine retrieval stats.
  • Detect conflicts or inconsistencies across memory episodes to support curation and cleanup.

Quick Start

Run gaia memory search "topic" --limit 5 --json to retrieve matching memory entries.

Frequently Asked Questions about memory-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search episodic memory entries in Gaia by keyword?

Search Gaia's episodic memory by running gaia memory search with a topic or keyword and the --json flag to retrieve top scored matches from the Memory v2 index.

What is Gaia Memory v2 and how does its retrieval scoring work?

Gaia Memory v2 is an FTS5 SQLite database indexing past sessions with hybrid scoring that combines recency and retrieval count to rank episodic memory entries.

How do I detect conflicts or inconsistencies across memory episodes?

Detect memory conflicts across episodes by running the gaia memory CLI conflict detection commands to identify inconsistencies and support episodic memory cleanup.

Does this skill reorganize the MEMORY.md index and topic files?

This skill queries the Memory v2 index and does not reorganize the MEMORY.md index or topic files; load memory-curation instead for that specific reorganization task.

How do I retrieve detailed memory entries and retrieval stats from Gaia?

Retrieve detailed memory entries and retrieval stats by running gaia memory show to inspect specific episodic records stored within the Memory v2 index.

What format does the gaia memory search command output for downstream processing?

The gaia memory CLI outputs structured contract JSON when using the --json flag, formatting episodic memory search results for direct downstream processing consumption.