SpecMem Remember - Store Memories

Tool: mcp__specmem__save_memory

Usage

/specmem-remember <content>
/specmem-remember --type <type> --importance <level> --tags <tag1,tag2> <content>
/specmem-remember --metadata <key:value> --expires <ISO8601> <content>

Execution Rules

REQUIRED: content argument must be provided (non-empty string after parsing flags)

1. NO ARGS or EMPTY → Show Help below → STOP (do not call tool)
2. "help" or "-h" or "--help" → Show Help below → STOP (do not call tool)
3. HAS CONTENT → Parse args and execute tool below

Execute

Step 1: Parse the input for optional flags:

• --type <value> → memoryType (default: "semantic")
• --importance <value> → importance (default: "medium")
• --tags <value> → tags array (comma-separated)
• --metadata <key:value> → metadata object (format: key:value or JSON)
• --expires <ISO8601> → expiresAt (ISO 8601 date-time string)
• Everything remaining after flags → content

Step 2: Validate content exists:

• If content is empty or whitespace-only → Show Help → STOP

Step 3: Call the MCP tool:

You MUST invoke mcp__specmem__save_memory with these parameters:

content: "<the parsed content string>" (REQUIRED)
memoryType: "<type>" (optional, default: "semantic")
importance: "<level>" (optional, default: "medium")
tags: ["tag1", "tag2"] (optional, parsed from comma-separated)
metadata: {key: "value"} (optional, additional structured data)
expiresAt: "ISO8601 date-time" (optional, when memory should expire)
imageBase64: "base64 string" (optional, base64-encoded image data)
imageMimeType: "image/png" (optional, MIME type for image)

Example tool invocation for /specmem-remember The API uses JWT:

mcp__specmem__save_memory({
  "content": "The API uses JWT",
  "memoryType": "semantic",
  "importance": "medium"
})

Example with metadata and expiration:

mcp__specmem__save_memory({
  "content": "Temporary session data for debugging",
  "memoryType": "working",
  "importance": "low",
  "tags": ["debug", "session"],
  "metadata": {"sessionId": "abc123", "environment": "dev"},
  "expiresAt": "2026-01-22T00:00:00Z"
})

Help

SPECMEM REMEMBER - Store Persistent Memories

USAGE:
  /specmem-remember <content>
  /specmem-remember --type <type> --importance <level> --tags <tags> <content>
  /specmem-remember --metadata <key:value> --expires <ISO8601> <content>

MEMORY TYPES:
  episodic    - Events, experiences, temporal information
  semantic    - Facts, knowledge, general information (default)
  procedural  - How-to, processes, step-by-step instructions
  working     - Temporary info, short-term context

IMPORTANCE LEVELS:
  critical    - Mission-critical information, system failures
  high        - Very important, security issues, major decisions
  medium      - Standard importance (default)
  low         - Minor details, nice-to-know information
  trivial     - Minimal importance, temporary notes

OPTIONAL PARAMETERS:
  --tags <tag1,tag2>         - Comma-separated categorization tags
  --metadata <key:value>     - Additional structured data (JSON or key:value)
  --expires <ISO8601>        - Expiration date-time (ISO 8601 format)

FEATURES:
  • Auto-splitting for large content (>50KB automatically chunked)
  • Image support via imageBase64 and imageMimeType parameters
  • Unlimited content length with automatic chunking
  • Project-aware storage with automatic namespace isolation

EXAMPLES:
  /specmem-remember The API uses JWT tokens for authentication
  /specmem-remember --type procedural Run npm test before commit
  /specmem-remember --importance high --tags auth,security Use HTTPS only
  /specmem-remember --type working --expires 2026-01-25T00:00:00Z Temp debug data
  /specmem-remember --metadata env:production --tags deploy Deploy requires approval

TOOL SCHEMA (mcp__specmem__save_memory):
  content: string (REQUIRED) - Memory content to store
  memoryType: "episodic" | "semantic" | "procedural" | "working" (default: "semantic")
  importance: "critical" | "high" | "medium" | "low" | "trivial" (default: "medium")
  tags: string[] (default: []) - Categorization tags for search
  metadata: object (optional) - Additional structured data
  expiresAt: string (optional) - ISO 8601 date-time for expiration
  imageBase64: string (optional) - Base64-encoded image data
  imageMimeType: string (optional) - MIME type (e.g., image/png, image/jpeg)

RESPONSE:
  Success: {success: true, id: "uuid", message: "✓ stored (Xms)"}
  Chunked: {success: true, ids: ["uuid1", "uuid2"], message: "✓ stored N chunks"}
  Error: {success: false, message: "error description"}