How-to · Indexer
How to run the indexer and verify memory snapshots
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 pushWhy 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