memories.sh
CLI Reference

memories ingest

Import memories from existing IDE rule files.

memories ingest [source] [options]

Scan existing IDE rule files and extract memories from them. This is the fastest way to migrate an existing setup to memories.sh.

Arguments

ArgumentDescription
sourceSource name (cursor, claude, agents, copilot, windsurf, cline, roo, gemini) or a file path

Options

OptionDescription
--type <type>Override type for all imported memories
--dry-runPreview without importing
--allScan all known IDE rule file locations
--no-dedupSkip duplicate detection

Examples

Ingest from a specific tool:

memories ingest cursor
memories ingest claude

Ingest from all known locations:

memories ingest --all

Preview what would be imported:

memories ingest cursor --dry-run

Ingest from a custom file:

memories ingest ./my-rules.md --type rule

Behavior

  • Extracts bullet points, numbered items, and significant plain text from rule files
  • Auto-infers memory type from content keywords:
    • "always", "never", "must", "should" → rule
    • "chose", "decided", "because" → decision
    • Specific values, numbers, limits → fact
  • Skips files that were generated by memories.sh (detected by marker comment)
  • Deduplicates against existing memories using normalized content comparison
  • Scans both current and legacy file locations (e.g., .cursorrules, .windsurfrules)