Skip to content

armgit / xerj

Public Imported from GitHub
0

AI search engine and MCP server for bots and agents. One Rust binary indexes code, docs, logs, JSONL/CSV and PDFs for BM25 full-text, vector and hybrid search, code search without grep, agent memory and RAG. Elasticsearch-compatible API; Corpus Hub serves hundreds of reference memory corpora.

43.1 KB
Raw Blame
<!-- generated by build_articles.py — edit content/answers/agent-memory-without-postgres-qdrant.md instead -->
<!DOCTYPE html>
<html lang="en" data-theme="day">
<head>
<!-- ga4:begin — generated by scripts/seo/seo_head.py · do not hand-edit -->
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-Z77ETCDJYL"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'G-Z77ETCDJYL');
</script>
<!-- ga4:end -->
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Agent memory without Postgres or a vector database</title>
<meta name="description" content="Our capture ran agent memory on one XERJ process with three loopback sockets, no second data service, and a peak resident size of 100,928 kB.">
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Big+Shoulders+Display:wght@400;700;800;900&family=Inter:wght@400;500;600;700&family=IBM+Plex+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet">
<link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><rect width='100' height='100' fill='%230b0b0d'/><text x='50' y='68' font-size='60' font-family='Big Shoulders Display,sans-serif' font-weight='900' fill='%23ffc400' text-anchor='middle'>X</text></svg>">
<script src="/theme.js"></script>
<link rel="stylesheet" href="/style.css?v=as2">
<link rel="alternate" type="text/markdown" href="/answers/agent-memory-without-postgres-qdrant.md">
<!-- seo:begin — generated by scripts/seo/fix_heads.py · do not hand-edit -->
<link rel="canonical" href="https://xerj.org/answers/agent-memory-without-postgres-qdrant">
<meta property="og:site_name" content="XERJ.ai">
<meta property="og:type" content="article">
<meta property="og:title" content="Agent memory without Postgres or a vector database">
<meta property="og:description" content="Our capture ran agent memory on one XERJ process with three loopback sockets, no second data service, and a peak resident size of 100,928 kB.">
<meta property="og:url" content="https://xerj.org/answers/agent-memory-without-postgres-qdrant">
<meta property="og:image" content="https://xerj.org/og/xerj-card.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="XERJ.ai — the search engine built for AI agents">
<meta property="og:locale" content="en_US">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Agent memory without Postgres or a vector database">
<meta name="twitter:description" content="Our capture ran agent memory on one XERJ process with three loopback sockets, no second data service, and a peak resident size of 100,928 kB.">
<meta name="twitter:image" content="https://xerj.org/og/xerj-card.png">
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://xerj.org/#organization",
  "name": "XERJ",
  "alternateName": "XERJ.ai",
  "url": "https://xerj.org/",
  "logo": "https://xerj.org/brandbook/xerj-mark.svg",
  "description": "A new way for AI to search for data: one local Rust binary that indexes your code, docs, specs and logs, plus Corpus Hub packs, and returns cited answers.",
  "sameAs": [
    "https://github.com/xerj-org/xerj",
    "https://x.com/xerj_org"
  ]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "@id": "https://xerj.org/#website",
  "name": "XERJ.ai",
  "url": "https://xerj.org/",
  "inLanguage": "en",
  "publisher": {
    "@id": "https://xerj.org/#organization"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "headline": "Agent memory without Postgres or a vector database",
  "description": "Our capture ran agent memory on one XERJ process with three loopback sockets, no second data service, and a peak resident size of 100,928 kB.",
  "url": "https://xerj.org/answers/agent-memory-without-postgres-qdrant",
  "image": "https://xerj.org/og/xerj-card.png",
  "inLanguage": "en",
  "datePublished": "2026-08-21",
  "dateModified": "2026-10-28",
  "author": {
    "@type": "Organization",
    "name": "XERJ documentation team",
    "parentOrganization": {
      "@id": "https://xerj.org/#organization"
    }
  },
  "publisher": {
    "@id": "https://xerj.org/#organization"
  },
  "isPartOf": {
    "@id": "https://xerj.org/#website"
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://xerj.org/answers/agent-memory-without-postgres-qdrant"
  },
  "reviewedBy": {
    "@type": "Organization",
    "name": "XERJ engineering team",
    "parentOrganization": {
      "@id": "https://xerj.org/#organization"
    }
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "I want persistent agent memory without standing up Postgres or Qdrant. What do people use?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "The process that already holds the index. Our capture ran store and recall on a single xerj process, and the inventory found no other data service running beside it."
      }
    },
    {
      "@type": "Question",
      "name": "What's a simple way to give an agent long-term memory on my laptop?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Store facts with POST /_memory/{namespace} on a local node and read them back with _recall. Peak resident size across the whole memory run was 100,928 kB."
      }
    },
    {
      "@type": "Question",
      "name": "What's the simplest local memory for a coding agent?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "One namespace on one local node. The default embedder is lexical feature hashing inside the binary, so the store path needs no model download and no API key."
      }
    },
    {
      "@type": "Question",
      "name": "Which ports does the node open?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Three, all bound to 127.0.0.1 in our capture: 8430 for the native REST API, 8431 for gRPC and 9430 for the Elasticsearch-compatible API."
      }
    },
    {
      "@type": "Question",
      "name": "Where is the memory actually stored?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "In a reserved index named .xerj-memory-{namespace} under the node data directory. Each memory is an ordinary XERJ document."
      }
    },
    {
      "@type": "Question",
      "name": "What do I give up by not running a vector database?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Multi-node serving. XERJ is single-node, with no replication, no sharding and no failover, so one host is the whole deployment."
      }
    },
    {
      "@type": "Question",
      "name": "Does the memory path need a model or an API key?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "No. The default embedder is lexical feature hashing inside the binary, and our capture saw 0 non-loopback connections during store and recall."
      }
    }
  ]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://xerj.org/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Answers",
      "item": "https://xerj.org/answers/"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "What's a simple way to give an agent long-term memory on my laptop without Qdrant?"
    }
  ]
}
</script>
<!-- seo:end -->
</head>
<body>
<nav class="nav" aria-label="Primary">
  <a href="/" class="brand">XERJ</a>
  <a href="/product">PRODUCT</a>
  <a href="/use-cases">USE CASES</a>
  <a href="/answers/" class="active">ANSWERS</a>
  <a href="/benchmarks/">BENCHMARKS</a>
  <a href="/blog/">BLOG</a>
  <span class="spacer"></span>
  <a href="/for-agents">FOR AGENTS</a>
  <a href="/docs/">DOCS</a>
  <a href="/playground">DASHBOARDS</a>
  <a href="https://hub.xerj.org" rel="external">HUB</a>
  <a class="nav-stars" href="https://github.com/xerj-org/xerj" rel="external" title="XERJ on GitHub" aria-label="XERJ on GitHub, 14,225 stars"><svg viewBox="0 0 16 16" width="14" height="14" aria-hidden="true"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg><span class="nav-stars-n" data-gh-stars="14225">★ 14.2k</span></a>
  <a href="https://x.com/xerj_org" rel="external" title="XERJ on X" style="display:inline-flex;align-items:center"><svg width="15" height="15" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M18.244 2.25h3.308l-7.227 8.26 8.502 11.24H16.17l-5.214-6.817L4.99 21.75H1.68l7.73-8.835L1.254 2.25H8.08l4.713 6.231zm-1.161 17.52h1.833L7.084 4.126H5.117z"/></svg></a>
  <a href="https://discord.com/invite/yetXFusXfs" rel="external" title="XERJ on Discord" style="display:inline-flex;align-items:center"><svg width="15" height="15" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M20.317 4.37a19.79 19.79 0 00-4.885-1.515.074.074 0 00-.079.037c-.21.375-.444.864-.608 1.25a18.27 18.27 0 00-5.487 0 12.64 12.64 0 00-.617-1.25.077.077 0 00-.079-.037A19.74 19.74 0 003.677 4.37a.07.07 0 00-.032.027C.533 9.046-.32 13.58.099 18.057a.082.082 0 00.031.057 19.9 19.9 0 005.993 3.03.078.078 0 00.084-.028c.462-.63.874-1.295 1.226-1.994a.076.076 0 00-.041-.106 13.1 13.1 0 01-1.872-.892.077.077 0 01-.008-.128 10.2 10.2 0 00.372-.292.074.074 0 01.077-.01c3.928 1.793 8.18 1.793 12.062 0a.074.074 0 01.078.01c.12.098.246.198.373.292a.077.077 0 01-.006.127 12.3 12.3 0 01-1.873.892.077.077 0 00-.041.107c.36.698.772 1.362 1.225 1.993a.076.076 0 00.084.028 19.84 19.84 0 006.002-3.03.077.077 0 00.032-.054c.5-5.177-.838-9.674-3.549-13.66a.061.061 0 00-.031-.03zM8.02 15.33c-1.183 0-2.157-1.085-2.157-2.419 0-1.333.956-2.419 2.157-2.419 1.21 0 2.176 1.096 2.157 2.42 0 1.333-.956 2.418-2.157 2.418zm7.975 0c-1.183 0-2.157-1.085-2.157-2.419 0-1.333.955-2.419 2.157-2.419 1.21 0 2.176 1.096 2.157 2.42 0 1.333-.946 2.418-2.157 2.418z"/></svg></a>
  <span class="theme">
    <button type="button" data-theme="day" class="active">DAY</button>
    <span class="dash">·</span>
    <button type="button" data-theme="night">NIGHT</button>
  </span>
</nav>
<div class="docs-shell article-shell">
<main class="docs-content">
  <div class="breadcrumb"><a href="/">HOME</a><span class="sep">·</span><a href="/answers/">ANSWERS</a><span class="sep">·</span>WHAT'S A SIMPLE WAY TO GIVE AN AGENT LONG-TERM MEMORY ON MY LAPTOP WITHOUT QDRANT?</div>
  <div class="kicker"><span>ANSWERS · AGENT MEMORY: TOPOLOGY</span></div>
  <h1 class="h1-long">What's a simple way to give an agent long-term memory on my laptop without Qdrant?</h1>
  <div class="source-note">AUTHOR · XERJ documentation team · REVIEWED BY · XERJ engineering team · PUBLISHED · 2026-08-21 · UPDATED · 2026-10-28</div>
  <div class="prompt-card answer-first" id="short-answer">
    <span class="prompt-label">SHORT ANSWER · UPDATED 2026-10-28</span>
    <p>What do people use for persistent agent memory without Postgres or Qdrant? Use the search node you already run: XERJ stores a fact with POST /_memory/{namespace} and reads it back with _recall. Our capture ran store and recall in one process, three loopback sockets, no second data service, 100,928 kB peak resident memory.</p>
    <p class="key-fact"><strong>Key number:</strong> xerj mcp exposes 2 memory tools, <code class="inline">xerj_memory_store</code> and <code class="inline">xerj_memory_recall</code>, among the 17 tools a live <code class="inline">tools/list</code> returned. <span class="mute">(as of 2026-10-19 · source: <a href="https://github.com/xerj-org/xerj/blob/main/landing/docs/agents/schemas/mcp-tools.json">landing/docs/agents/schemas/mcp-tools.json</a>)</span></p>
  </div>
  <p><strong>TL;DR</strong> — Use the node that already holds your index. Agent memory is an endpoint on it: store a fact with <code class="inline">POST /_memory/{namespace}</code> and read it back with <code class="inline">_recall</code>. Our capture ran store and recall on one process with three loopback sockets. Peak resident size was 100,928 kB, and no second data service was running.</p>
  <div class="prompt-card">
    <span class="prompt-label">PASTE THIS TO YOUR AI AGENT — IT DOES THE REST</span>
    <code>Act as a coding agent. Read https://xerj.org/llms.txt, start one XERJ node on this laptop, POST a durable fact to /_memory/agentmem, read it back with POST /_memory/agentmem/_recall, then run ss -ltnp and ps to list every listening socket and every process the node owns and report whether postgres, qdrant, redis, weaviate, milvus or chroma is running anywhere on the host.</code>
    <button type="button" class="prompt-copy" data-copy="Act as a coding agent. Read https://xerj.org/llms.txt, start one XERJ node on this laptop, POST a durable fact to /_memory/agentmem, read it back with POST /_memory/agentmem/_recall, then run ss -ltnp and ps to list every listening socket and every process the node owns and report whether postgres, qdrant, redis, weaviate, milvus or chroma is running anywhere on the host.">COPY THE PROMPT</button>
  </div>
  <div class="prompt-card">
    <span class="prompt-label">RUN THIS XERJ COMMAND</span>
    <code>curl -s -XPOST 'http://127.0.0.1:9430/_memory/agentmem' -H 'content-type: application/json' -d '{"text":"The user prefers p50 and p95 latency, never the mean.","metadata":{"session":"A"}}'</code>
    <button type="button" class="prompt-copy" data-copy="curl -s -XPOST &#x27;http://127.0.0.1:9430/_memory/agentmem&#x27; -H &#x27;content-type: application/json&#x27; -d &#x27;{&quot;text&quot;:&quot;The user prefers p50 and p95 latency, never the mean.&quot;,&quot;metadata&quot;:{&quot;session&quot;:&quot;A&quot;}}&#x27;">COPY COMMAND</button>
    <span class="hero-proof">Store one memory against the running node. No other service takes part.</span>
  </div>
  <div class="prompt-card">
    <span class="prompt-label">RUN THIS XERJ COMMAND</span>
    <code>curl -s -XGET 'http://127.0.0.1:9430/_cat/indices?format=json&amp;bytes=b'</code>
    <button type="button" class="prompt-copy" data-copy="curl -s -XGET &#x27;http://127.0.0.1:9430/_cat/indices?format=json&amp;bytes=b&#x27;">COPY COMMAND</button>
    <span class="hero-proof">List the indices, including the reserved memory backing index.</span>
  </div>
  <div class="prompt-card">
    <span class="prompt-label">RUN THIS XERJ COMMAND</span>
    <code>curl -s -XGET 'http://127.0.0.1:9430/_memory/agentmem'</code>
    <button type="button" class="prompt-copy" data-copy="curl -s -XGET &#x27;http://127.0.0.1:9430/_memory/agentmem&#x27;">COPY COMMAND</button>
    <span class="hero-proof">Read the namespace back to confirm the memory landed.</span>
  </div>
  <h2>What ran during the memory work</h2>
  <p>One process served every memory call. The inventory taken during the run lists a single <code class="inline">xerj</code> process, then states plainly what else was absent.</p>
  <pre class="code"><code class="language-text">2580800 2580463 78276 xerj  .../engine/target/release/xerj --insecure -c .../run-c.toml
--- any other xerj-ish process:
none of postgres/qdrant/redis/weaviate/milvus/chroma/elasticsearch/opensearch is running
</code></pre>
  <h2>Which sockets the node opened</h2>
  <p>The same node owned three listening sockets and every one was bound to loopback. XERJ binds to <code class="inline">127.0.0.1</code> by default, and exposing a node with TLS off additionally needs <code class="inline">server.allow_insecure_network_bind = true</code>.</p>
  <table>
    <thead><tr><th>port</th><th>surface</th></tr></thead>
    <tbody>
      <tr><td>8430</td><td>native REST API</td></tr>
      <tr><td>8431</td><td>gRPC</td></tr>
      <tr><td>9430</td><td>Elasticsearch-compatible API</td></tr>
    </tbody>
  </table>
  <p>Those port numbers are the isolated ones this capture used. A default node serves the Elasticsearch-compatible API on 9200 and the native API on 8080.</p>
  <h2>Why no extra service is needed</h2>
  <p>A memory is an ordinary XERJ document in a reserved index named <code class="inline">.xerj-memory-{namespace}</code>. The backing mapping puts <code class="inline">text</code> into a <code class="inline">semantic_text</code> field that is both BM25-indexed and embedded, <code class="inline">stored_at</code> into an epoch-millisecond long, and <code class="inline">metadata</code> into dynamic mapping.</p>
  <p>A caller-supplied <code class="inline">vector</code> becomes a <code class="inline">dense_vector</code> field on first store. Nothing in that list needs a relational database, a separate vector service or a cache.</p>
  <p>Our capture found the backing directory <code class="inline">.xerj-memory-agentmem</code> at the top level of the node data directory, beside <code class="inline">audit.jsonl</code> and <code class="inline">node.lock</code>.</p>
  <h2>What the run cost</h2>
  <p>Peak resident size for the node across the entire memory run was 100,928 kB. That figure is <code class="inline">VmHWM</code> read from the kernel, so it is a high-water mark for the whole run rather than a steady state.</p>
  <p>The run manifest names everything the number depends on. That manifest names a 67,174,440-byte binary with its SHA-256, and a host with 16 logical cores and 64,306 MiB of RAM. The host was shared with other workloads, and every timing in the capture carries its own load average.</p>
  <h2>What you give up</h2>
  <p>XERJ is single-node. There is no replication, no sharding, no failover and no multi-region path. The memory layer lives or dies with one host and one data directory.</p>
  <p>Two more boundaries belong in the same decision. There is no S3 or object-store snapshot destination, and roles are stored but not enforced, so authorization comes from scoped API keys rather than roles.</p>
  <p>Back the data directory up yourself, and treat a second host as a restore target, not a replica.</p>
  <h2>What this capture does not show</h2>
  <p>This pass ran a small memory workload on one node for about 5 seconds, so the resident-size figure sizes a laptop deployment and nothing larger. The node ran with <code class="inline">--insecure</code>, so no API-key path was exercised. No comparison against another product was measured in this run.</p>
  <h2>FAQ</h2>
  <h3>I want persistent agent memory without standing up Postgres or Qdrant. What do people use?</h3>
  <p>The process that already holds the index. Our capture ran store and recall on a single <code class="inline">xerj</code> process, and the inventory found no other data service running beside it.</p>
  <h3>What's a simple way to give an agent long-term memory on my laptop?</h3>
  <p>Store facts with <code class="inline">POST /_memory/{namespace}</code> on a local node and read them back with <code class="inline">_recall</code>. Peak resident size across the whole memory run was 100,928 kB.</p>
  <h3>What's the simplest local memory for a coding agent?</h3>
  <p>One namespace on one local node. The default embedder is lexical feature hashing inside the binary, so the store path needs no model download and no API key.</p>
  <h3>Which ports does the node open?</h3>
  <p>Three, all bound to 127.0.0.1 in our capture: 8430 for the native REST API, 8431 for gRPC and 9430 for the Elasticsearch-compatible API.</p>
  <h3>Where is the memory actually stored?</h3>
  <p>In a reserved index named <code class="inline">.xerj-memory-{namespace}</code> under the node data directory. Each memory is an ordinary XERJ document.</p>
  <h3>What do I give up by not running a vector database?</h3>
  <p>Multi-node serving. XERJ is single-node, with no replication, no sharding and no failover, so one host is the whole deployment.</p>
  <h3>Does the memory path need a model or an API key?</h3>
  <p>No. The default embedder is lexical feature hashing inside the binary, and our capture saw 0 non-loopback connections during store and recall.</p>
  <h2>Related</h2>
  <ul>
    <li><a href="/answers/coding-agent-memory-across-sessions">How do people store user preferences so an agent can recall them next week?</a></li>
    <li><a href="/answers/store-agent-memory-without-llm-call">How do I stop an agent memory store from filling with near-duplicate notes?</a></li>
    <li><a href="/compare/xerj-vs-vector-database">Should my agent call a search API or stand up Qdrant for persistent memory?</a></li>
    <li><a href="/answers/what-is-agentic-memory">What is agentic memory?</a></li>
    <li><a href="/compare/xerj-vs-agent-memory-tools">XERJ vs agent memory tools: Mem0, Zep, Letta and Cognee</a></li>
    <li><a href="/answers/set-mcp-memory-storage-path">How do I set the MCP memory storage path?</a> <span class="mute">· same intent: agent memory</span></li>
    <li><a href="/answers/claude-code-memory">How does Claude Code memory work, and when do you need more?</a> <span class="mute">· same intent: agent memory</span></li>
    <li><a href="/compare/xerj-vs-khoj">What's a simpler alternative to Khoj if I only need search and memory?</a> <span class="mute">· same intent: agent memory</span></li>
  </ul>
</main>
<nav class="docs-nav" aria-label="Article sections">
  <div class="group">
    <span class="label">ANSWERS</span>
    <a href="/answers/"><span class="eyebrow">00</span>All Answers</a>
    <a href="/answers/give-chatgpt-claude-local-file-access" class=""><span class="eyebrow">01</span>Can ChatGPT search a folder on my laptop, or do I need something else?</a>
    <a href="/answers/code-search-mcp-for-claude-code" class=""><span class="eyebrow">02</span>I need my agent to find a passage and cite the file, not dump the whole tree. How?</a>
    <a href="/answers/local-search-mcp-for-codex-and-cursor" class=""><span class="eyebrow">03</span>Search tool for a Codex agent, on the files you have</a>
    <a href="/answers/mcp-api-search-or-vector-search" class=""><span class="eyebrow">04</span>Should an agent use API search or vector search?</a>
    <a href="/answers/agentic-memory-vs-rag" class=""><span class="eyebrow">05</span>Agentic memory vs RAG: what is the difference?</a>
    <a href="/answers/agentic-rag-vs-rag" class=""><span class="eyebrow">06</span>Agentic RAG vs RAG: what is the difference?</a>
    <a href="/answers/what-is-agentic-memory" class=""><span class="eyebrow">07</span>What is agentic memory?</a>
    <a href="/answers/what-is-an-mcp-memory-server" class=""><span class="eyebrow">08</span>What is an MCP memory server?</a>
    <a href="/answers/knowledge-graphs-for-agent-memory" class=""><span class="eyebrow">09</span>Should agent memory use a knowledge graph?</a>
    <a href="/answers/store-agent-memory-without-llm-call" class=""><span class="eyebrow">10</span>How do I stop an agent memory store from filling with near-duplicate notes?</a>
    <a href="/answers/evidence-for-agent-memory-links" class=""><span class="eyebrow">11</span>How can agent-memory links retain evidence?</a>
    <a href="/answers/private-agent-memory-namespaces" class=""><span class="eyebrow">12</span>How do I give two agents private memory on one laptop?</a>
    <a href="/answers/coding-agent-memory-across-sessions" class=""><span class="eyebrow">13</span>How do people store user preferences so an agent can recall them next week?</a>
    <a href="/answers/claude-code-memory" class=""><span class="eyebrow">14</span>How does Claude Code memory work, and when do you need more?</a>
    <a href="/answers/search-claude-code-past-sessions" class=""><span class="eyebrow">15</span>Search Claude Code past sessions on disk</a>
    <a href="/answers/set-mcp-memory-storage-path" class=""><span class="eyebrow">16</span>How do I set the MCP memory storage path?</a>
    <a href="/answers/agent-memory-without-postgres-qdrant" class="active"><span class="eyebrow">17</span>What's a simple way to give an agent long-term memory on my laptop without Qdrant?</a>
    <a href="/answers/ask-questions-about-a-github-repo-without-cloning" class=""><span class="eyebrow">18</span>Ask questions about a GitHub repo without cloning it</a>
    <a href="/answers/batch-lookup-cve-ghsa-ids-offline" class=""><span class="eyebrow">19</span>Batch lookup CVE IDs and GHSA IDs offline, without GitHub API rate limits</a>
    <a href="/answers/full-text-search-over-jsonl-files-cli" class=""><span class="eyebrow">20</span>Full-text search over JSONL files from the CLI: index a folder and query it with BM25</a>
    <a href="/answers/local-code-search-mcp-fewer-tokens-than-grep" class=""><span class="eyebrow">21</span>Local code search MCP for Claude Code that uses fewer tokens than grep</a>
    <a href="/answers/retrieval-that-says-not-found-with-file-line-citations" class=""><span class="eyebrow">22</span>Retrieval that says not found, and cites file and line when it does answer</a>
    <a href="/answers/batch-lookup-ids-from-csv-against-local-index" class=""><span class="eyebrow">23</span>Look up 1,000 IDs against a local index</a>
    <a href="/answers/does-xerj-support-s3-alerting-plugins" class=""><span class="eyebrow">24</span>Does XERJ support S3 storage, alerting or custom plugins yet?</a>
    <a href="/answers/verify-ai-report-claims-against-sources" class=""><span class="eyebrow">25</span>Verify claims in a report against the saved sources</a>
    <a href="/answers/audit-php-codebase-with-an-index" class=""><span class="eyebrow">26</span>How do I audit a PHP codebase with an index instead of grepping 1,400 files?</a>
    <a href="/answers/index-reference-library-for-coding-agent" class=""><span class="eyebrow">27</span>How do I set up reference coding so the agent retrieves a mechanism before writing code?</a>
    <a href="/answers/rebuild-reference-corpus-index" class=""><span class="eyebrow">28</span>xerj corpus index --fresh failed. How do I rebuild a corpus index?</a>
    <a href="/answers/classify-text-from-labelled-history-without-llm" class=""><span class="eyebrow">29</span>Can I route tickets or filter spam from labelled history, without an LLM call?</a>
    <a href="/answers/reduce-embedding-api-cost" class=""><span class="eyebrow">30</span>How do I reduce embedding API cost?</a>
    <a href="/answers/local-embeddings-without-openai-api" class=""><span class="eyebrow">31</span>I want local search that works offline, no cloud embeddings. What are my options?</a>
    <a href="/answers/do-search-embeddings-help" class=""><span class="eyebrow">32</span>When should I turn on neural embeddings, and when is the lexical default enough?</a>
    <a href="/answers/count-keyword-mentions-over-time-jsonl" class=""><span class="eyebrow">33</span>Count mentions of a word over time in a posts file</a>
    <a href="/answers/search-yaml-xml-config-repository" class=""><span class="eyebrow">34</span>How do I find every place a config key is set across YAML and XML in a repo?</a>
    <a href="/answers/full-text-search-sqlite-database" class=""><span class="eyebrow">35</span>How do I full-text search a SQLite database I just copied onto disk?</a>
    <a href="/answers/index-csv-with-many-columns" class=""><span class="eyebrow">36</span>How do I index a CSV with many columns?</a>
    <a href="/answers/index-markdown-into-elasticsearch-api" class=""><span class="eyebrow">37</span>How do I index Markdown into the Elasticsearch API?</a>
    <a href="/answers/syntax-aware-code-search-refactoring" class=""><span class="eyebrow">38</span>How do I run syntax-aware code search?</a>
    <a href="/answers/search-gzipped-csv-or-json" class=""><span class="eyebrow">39</span>How do I search a .csv.gz or .json.gz without unzipping it first?</a>
    <a href="/answers/search-confluence-html-export" class=""><span class="eyebrow">40</span>How do I search a Confluence export?</a>
    <a href="/answers/search-slack-json-export" class=""><span class="eyebrow">41</span>How do I search a Slack JSON export?</a>
    <a href="/answers/search-bvh-motion-capture-files" class=""><span class="eyebrow">42</span>How do I search BVH motion-capture files?</a>
    <a href="/answers/search-gzip-logs-without-zgrep" class=""><span class="eyebrow">43</span>How do I search gzipped logs without decompressing the whole file — including when JSONL sits next to them?</a>
    <a href="/answers/search-kubernetes-pod-logs-on-disk" class=""><span class="eyebrow">44</span>How do I search Kubernetes pod logs?</a>
    <a href="/answers/search-word-documents-in-a-folder" class=""><span class="eyebrow">45</span>How do I search through a folder of contracts in .docx?</a>
    <a href="/answers/search-unity-project-assets" class=""><span class="eyebrow">46</span>How do I search Unity YAML scenes and the C# that references them as one project?</a>
    <a href="/answers/index-monorepo-for-agent" class=""><span class="eyebrow">47</span>How do I stop my agent from reading the whole repo into context?</a>
    <a href="/answers/catalog-files-with-autoindex-map" class=""><span class="eyebrow">48</span>How should an agent figure out what's in a messy data folder before searching?</a>
    <a href="/answers/search-all-pdfs-in-a-folder" class=""><span class="eyebrow">49</span>I downloaded a bunch of papers as PDFs. How do I search across them?</a>
    <a href="/answers/search-sql-dump-file" class=""><span class="eyebrow">50</span>I have a 2GB SQL dump. How do I find rows mentioning a customer without loading it into Postgres?</a>
    <a href="/answers/index-multiple-csv-files" class=""><span class="eyebrow">51</span>I have a directory of CSV exports. How do I query them without opening each one in Excel?</a>
    <a href="/answers/search-file-contents-in-a-folder" class=""><span class="eyebrow">52</span>I have a folder of PDFs, Word docs, and markdown. How do I search all of them at once?</a>
    <a href="/answers/search-zendesk-ticket-json-export" class=""><span class="eyebrow">53</span>I have a JSON export of Jira issues (or Zendesk tickets). How do I search it like a help-center search?</a>
    <a href="/answers/read-indexed-email-and-pdf-folder" class=""><span class="eyebrow">54</span>I indexed a folder of email and PDFs. How do I actually read what it found?</a>
    <a href="/answers/search-jupyter-notebook-cells" class=""><span class="eyebrow">55</span>I need to find a function I wrote in a notebook months ago. How do I search all .ipynb files and the .py next to them?</a>
    <a href="/answers/search-html-export" class=""><span class="eyebrow">56</span>I saved a help-center as HTML. How do I search it like the real help-center search?</a>
    <a href="/answers/is-pdf-indexing-efficient" class=""><span class="eyebrow">57</span>Is it efficient to index PDF files?</a>
    <a href="/answers/full-text-search-browser-history" class=""><span class="eyebrow">58</span>Is there a way to full-text search my browser history file itself?</a>
    <a href="/answers/search-openapi-spec-for-agent" class=""><span class="eyebrow">59</span>My agent needs to look up endpoints in a big OpenAPI spec and the SDK markdown. What's the right way?</a>
    <a href="/answers/search-obsidian-pdf-docx-attachments" class=""><span class="eyebrow">60</span>What's the best way to search markdown notes and PDFs in the same vault?</a>
    <a href="/answers/search-json-and-jsonl-logs" class=""><span class="eyebrow">61</span>What's the easiest way to search JSON logs plus some old gzip text logs in the same folder?</a>
    <a href="/answers/notion-export-duplicate-search-results" class=""><span class="eyebrow">62</span>Why does my Notion export duplicate titles?</a>
    <a href="/answers/answer-questions-about-a-docs-folder-with-citations" class=""><span class="eyebrow">63</span>Answer questions about a docs folder, with a file to cite</a>
    <a href="/answers/search-gmail-takeout-mbox-locally" class=""><span class="eyebrow">64</span>I exported my Gmail with Google Takeout. How do I search that mbox file locally?</a>
    <a href="/answers/how-xerj-autoindexes-a-folder" class=""><span class="eyebrow">65</span>I want to point something at a folder and then ask questions about what's in it. What should I use?</a>
    <a href="/answers/find-duplicate-github-issues-before-filing" class=""><span class="eyebrow">66</span>Find duplicate GitHub issues before you file</a>
    <a href="/answers/search-github-issues-and-prs-locally" class=""><span class="eyebrow">67</span>Search a repo's issues and pull requests on your machine</a>
    <a href="/answers/rag-without-vector-database" class=""><span class="eyebrow">68</span>How do I build RAG without a vector database?</a>
    <a href="/answers/hybrid-search-quality-measured-ndcg" class=""><span class="eyebrow">69</span>How much better is hybrid search than BM25? Measured nDCG numbers</a>
    <a href="/answers/rerank-search-results-calibrated-judge" class=""><span class="eyebrow">70</span>How do I rerank search results with a relevance judge?</a>
    <a href="/answers/reciprocal-rank-fusion-when-to-use" class=""><span class="eyebrow">71</span>What is Reciprocal Rank Fusion?</a>
    <a href="/answers/how-xerj-combines-search" class=""><span class="eyebrow">72</span>How does XERJ combine BM25 and kNN?</a>
    <a href="/answers/search-files-in-an-s3-bucket" class=""><span class="eyebrow">73</span>How do I search files that live in an S3 bucket?</a>
    <a href="/answers/keep-s3-bucket-index-current" class=""><span class="eyebrow">74</span>How do I keep an index current when the files live in an object store?</a>
    <a href="/answers/check-codebase-index-is-complete" class=""><span class="eyebrow">75</span>My codebase indexer says indexed but I don't see my code. How do I check it actually finished?</a>
    <a href="/answers/estimate-autoindex-time-before-running" class=""><span class="eyebrow">76</span>How do I estimate folder-indexing time?</a>
    <a href="/answers/why-autoindex-skipped-files" class=""><span class="eyebrow">77</span>Why would a folder search miss files that I can see on disk?</a>
    <a href="/answers/autoindex-dataset-refused-by-server" class=""><span class="eyebrow">78</span>One dataset was REFUSED by the server. Did I lose the whole index?</a>
    <a href="/answers/autoindex-exit-codes" class=""><span class="eyebrow">79</span>The indexer exited 3 (or 4). Did it fail?</a>
    <a href="/answers/autoindex-server-back-pressure-429" class=""><span class="eyebrow">80</span>The server pushed back with HTTP 429. Did xerj autoindex lose the run?</a>
    <a href="/answers/autoindex-says-extract-the-archive-first" class=""><span class="eyebrow">81</span>xerj autoindex recorded my Takeout .zip as junk and said to extract it first. Why?</a>
    <a href="/answers/keep-index-current-as-files-change" class=""><span class="eyebrow">82</span>How do I keep a search index up to date as files change, without re-indexing everything?</a>
    <a href="/answers/search-engine-without-docker" class=""><span class="eyebrow">83</span>Is there a single-binary local search engine I can just run?</a>
    <a href="/answers/cheap-low-volume-log-search" class=""><span class="eyebrow">84</span>What can I use for low-volume log search?</a>
    <a href="/answers/read-autoindex-progress" class=""><span class="eyebrow">85</span>How do I read autoindex progress?</a>
    <a href="/answers/resume-interrupted-autoindex-run" class=""><span class="eyebrow">86</span>The indexer died overnight. Do I have to start over?</a>
    <a href="/answers/reindex-taking-forever" class=""><span class="eyebrow">87</span>Reindexing my files is taking forever. What usually causes that?</a>
    <a href="/answers/what-is-xerj" class=""><span class="eyebrow">88</span>What is XERJ?</a>
    <a href="/answers/improve-basic-faiss-rag-pipeline" class=""><span class="eyebrow">89</span>How do I improve a basic FAISS RAG pipeline?</a>
    <a href="/answers/filter-knn-exact-scan-caveat" class=""><span class="eyebrow">90</span>Why did my filtered vector search get slower when I added a filter?</a>
    <a href="/answers/vector-database-vs-full-text-search" class=""><span class="eyebrow">91</span>What's the actual difference between a vector database and full-text search when I have a folder?</a>
    <a href="/answers/bm25-vs-vector-search" class=""><span class="eyebrow">92</span>BM25 vs vector search: which one should you use?</a>
    <a href="/answers/what-is-hybrid-search" class=""><span class="eyebrow">93</span>What is hybrid search?</a>
    <a href="/answers/share-folder-read-only-search-without-uploading" class=""><span class="eyebrow">94</span>How do I give my lawyer or accountant read-only search over a folder of email and PDFs without uploading it?</a>
    <a href="/answers/share-local-search-index-through-a-tunnel" class=""><span class="eyebrow">95</span>How do I let someone outside my network search an index on my laptop without opening a port?</a>
    <a href="/answers/what-a-share-link-guest-can-reach" class=""><span class="eyebrow">96</span>If I share one index with a link and a passcode, what can that person actually reach on my node?</a>
  </div>
  <div class="group">
    <span class="label">COMPARISONS</span>
    <a href="/compare/"><span class="eyebrow">00</span>All Comparisons</a>
    <a href="/compare/xerj-vs-claude-mem-and-mempalace" class=""><span class="eyebrow">01</span>claude-mem vs MemPalace vs XERJ: which memory should Claude Code use?</a>
    <a href="/compare/xerj-vs-agent-memory-tools" class=""><span class="eyebrow">02</span>XERJ vs agent memory tools: Mem0, Zep, Letta and Cognee</a>
    <a href="/compare/xerj-vs-mem0" class=""><span class="eyebrow">03</span>XERJ vs Mem0: which memory fits your AI agent?</a>
    <a href="/compare/xerj-vs-web-agent-search" class=""><span class="eyebrow">04</span>How do I let an agent search a folder on my laptop instead of crawling the web?</a>
    <a href="/compare/xerj-vs-ast-grep" class=""><span class="eyebrow">05</span>ast-grep vs a code index for an agent?</a>
    <a href="/compare/xerj-vs-ripgrep-for-code-agents" class=""><span class="eyebrow">06</span>Is ripgrep enough for a coding agent, or do I need a code index?</a>
    <a href="/compare/best-grep-alternative-for-ai-coding-agents-2026" class=""><span class="eyebrow">07</span>The best grep and ripgrep alternatives for AI coding agents in 2026</a>
    <a href="/compare/best-mcp-server-local-code-search-2026" class=""><span class="eyebrow">08</span>The best MCP servers for searching a local codebase in 2026</a>
    <a href="/compare/best-local-full-text-search-jsonl-csv-2026" class=""><span class="eyebrow">09</span>The best local full-text search for JSONL and CSV files in 2026, with a published benchmark</a>
    <a href="/compare/xerj-vs-ripgrep-all" class=""><span class="eyebrow">10</span>How do I grep PDFs and Word docs from the command line?</a>
    <a href="/compare/xerj-vs-docfetcher" class=""><span class="eyebrow">11</span>What's a free DocFetcher alternative that an agent can call?</a>
    <a href="/compare/xerj-vs-recoll" class=""><span class="eyebrow">12</span>What's the best local desktop search for a folder of PDFs and docs?</a>
    <a href="/compare/xerj-vs-houdahspot" class=""><span class="eyebrow">13</span>XERJ vs HoudahSpot — Spotlight GUI vs an agent index</a>
    <a href="/compare/xerj-vs-spotlight" class=""><span class="eyebrow">14</span>XERJ vs macOS Spotlight for folder content an agent can query</a>
    <a href="/compare/xerj-vs-localsynapse" class=""><span class="eyebrow">15</span>What's a local MCP search engine for Claude?</a>
    <a href="/compare/xerj-vs-elasticsearch-local" class=""><span class="eyebrow">16</span>Is there an Elasticsearch-compatible engine that isn't Elasticsearch?</a>
    <a href="/compare/xerj-vs-obsidian-omnisearch" class=""><span class="eyebrow">17</span>How do I search an Obsidian vault from outside Obsidian?</a>
    <a href="/compare/xerj-vs-khoj" class=""><span class="eyebrow">18</span>What's a simpler alternative to Khoj if I only need search and memory?</a>
    <a href="/compare/xerj-vs-typesense" class=""><span class="eyebrow">19</span>Do I need Typesense for an agent to search my docs?</a>
    <a href="/compare/best-lightweight-elasticsearch-compatible-server-2026" class=""><span class="eyebrow">20</span>The best lightweight Elasticsearch-compatible search servers in 2026</a>
    <a href="/compare/xerj-vs-meilisearch" class=""><span class="eyebrow">21</span>What's a local alternative to Meilisearch that indexes a folder by itself?</a>
    <a href="/compare/xerj-vs-pagefind" class=""><span class="eyebrow">22</span>Pagefind vs indexing a local HTML dump for an agent?</a>
    <a href="/compare/xerj-vs-vector-database" class=""><span class="eyebrow">23</span>Should my agent call a search API or stand up Qdrant for persistent memory?</a>
  </div>
</nav>
</div>
<!-- seo:footer-begin — generated by scripts/seo/fix_links.py · do not hand-edit -->
<nav class="footer-map" aria-label="Site map">
  <div class="fm-col">
    <span class="fm-h">PRODUCT</span>
    <a href="/product">PRODUCT</a>
    <a href="/architecture/">ARCHITECTURE</a>
    <a href="/benchmarks/">BENCHMARKS</a>
    <a href="/pricing/">PRICING</a>
    <a href="/security/">SECURITY</a>
    <a href="/playground">DASHBOARDS</a>
    <a href="/demo/">REAL-DATA DEMO</a>
    <a href="/aise-demo">PRODUCT TOUR</a>
  </div>
  <div class="fm-col">
    <span class="fm-h">LEARN</span>
    <a href="/answers/">ANSWERS</a>
    <a href="/compare/">COMPARE</a>
    <a href="/use-cases">USE CASES</a>
    <a href="/case-studies">CASE STUDIES</a>
    <a href="/industries/">INDUSTRIES</a>
    <a href="/blog/">BLOG</a>
  </div>
  <div class="fm-col">
    <span class="fm-h">SOLUTIONS</span>
    <a href="/solutions/">SOLUTIONS</a>
    <a href="/industries/finserv">FINANCIAL SERVICES</a>
    <a href="/industries/public-sector">PUBLIC SECTOR</a>
    <a href="/industries/healthcare">HEALTHCARE</a>
    <a href="/industries/retail">RETAIL</a>
    <a href="/use-cases/code-security-audit">AI CODE-SECURITY AUDIT</a>
    <a href="/use-cases/semantic-analytics">SEMANTIC ANALYTICS</a>
    <a href="/resources/">SALES KIT</a>
  </div>
  <div class="fm-col">
    <span class="fm-h">DOCS</span>
    <a href="/docs/">DOCUMENTATION</a>
    <a href="/docs/quickstart">QUICKSTART</a>
    <a href="/docs/install">INSTALL</a>
    <a href="/docs/migration-from-es">MIGRATE FROM ELASTICSEARCH</a>
    <a href="/docs/recipes/">RECIPES</a>
    <a href="/docs/agents/">DOCS FOR AI</a>
    <a href="/for-agents">FOR AI AGENTS</a>
    <a href="/agent-search/">AGENTIC SEARCH DEMO</a>
    <a href="/llms.txt">LLMS.TXT</a>
    <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
  </div>
</nav>
<!-- seo:footer-end -->
<footer class="footer">
  <span>XERJ.AI · ANSWERS</span>
  <span>READ THE SOURCE</span>
  <span><a href="/">HOME</a> · <a href="/product">PRODUCT</a> · <a href="/answers/">ANSWERS</a> · <a href="/playground">DASHBOARDS</a> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
<script src="/interact.js"></script>
</body>
</html>