Skip to content
Back to Blog

How-to · Indexer

How to run the indexer and verify memory snapshots

January 19, 20269 min read

Understand the indexer service that ingests Git state, marks snapshots as verified, and powers fast search.

Ingest and verify are separate phases

The indexer accepts pending snapshots as soon as a push happens from the CLI or MCP server.

Verification happens when a git push webhook matches a pending snapshot by commit hash, turning it into a verified memory record.

This separation keeps real-time collaboration fast without compromising the audit trail.

Send a pending snapshot

vem push

Why verification matters

Pending updates are great for speed but risky if they are not backed by code. Verified updates carry the audit trail teams need.

This lets the cloud layer index knowledge without owning it and keeps Git as the canonical store.

Verified memory is what powers confident retrieval for agents and reporting for managers.

  • Verified snapshots are immutable
  • Search ranking prioritizes verified memory
  • Compliance and audits stay easy

Keep the index fast and scoped

Index only the memory artifacts you intend to query: tasks, decisions, and changelog data.

That keeps retrieval precise and avoids bloating the vector store with unrelated source files.

Use small, consistent summaries so the index can retrieve the right entries quickly.

Health checks to monitor

Track pending-to-verified conversion time so you know when Git verification is lagging.

Monitor failed ingestion events to avoid missing memory updates after deployments.

  • Webhook failures
  • Indexer queue depth
  • Verification latency