Memory

memory_search(query)

• Input: {q: string, limit: int=20, window_lines: int=50000, mode: "rg"|"jq"|"hybrid"="hybrid"}
• Default behavior (hybrid):
  1. tail -n window_lines memory.jsonl
  2. rg the query string (treat q as a literal substring by default; optionally support regex if q starts with /.../)
  3. from matches, parse/validate lines with jq (ignore malformed lines)
  4. return the most recent results first (since tail window is recent; preserve original order within window, or reverse if easier)
• If results < limit, expand window_lines exponentially (e.g., *4) up to a max (e.g., 1,000,000 lines) then stop.
• Output: {results: [json objects], truncated: bool, used_window_lines: int}

Executable scripts

This skill includes runnable reference implementations for the two interfaces:

• memory/scripts/memory_write (reads JSON from stdin; appends 1 JSONL line; prints JSON result)
• memory/scripts/memory_search (reads JSON from stdin; searches recent window; prints JSON result)

Examples:

printf '%s' '{"type":"note","content":"User prefers Python.","tags":["preference"]}' | memory/scripts/memory_write
printf '%s' '{"q":"Python","limit":5}' | memory/scripts/memory_search

CLI requirements

• Depend on standard unix tools: bash, touch, tail, rg (ripgrep), jq.
• Provide fallbacks: if rg missing, use grep; if jq missing, fail with a clear error.
• Make sure commands are safe with arbitrary user text (proper quoting).
• Ensure the skill returns structured JSON to the agent, not raw text logs.